Java Code Conventions / Соглашения по оформлению кода Java

→1 |Class/interface documentation comment (/**...*/) |See "Documentation Comments" on page 9 for information on what should be in this comment.
0 1 | комментарий по документации класса / интерфейса (/**...*/) | См. "Комментарии к документации" на стр. 9 для подробной информации, которая должна быть включена в этот комментарий.
→|Part of Class/Interface Declaration |Notes
0 |объявление части класса / интерфейса | примечания
→The following table describes the parts of a class or interface declaration, in the order that they should appear. See "Java Source File Example" on page 19 for an example that includes comments.
0 Приведенная ниже таблица описывает объявление части класса или интерфейса в порядке их появления. См. "Пример файла исходника Java" на стр. 19 для примера с комментариями.
→3.1.3 Class and Interface Declarations
0 3.1.3 Объявление классов и интерфейсов
→The first non-comment line of most Java source files is a package statement. After that, import statements can follow. For example:
0 Первая строка не-комментарий в большинстве исходников Java это сведения о пакете, после чего идут сведения о импорте. Например:
→3.1.2 Package and Import Statements
0 3.1.2. Сведения о пакете и импорте
→All source files should begin with a c-style comment that lists the programmer(s), the date, a copyright notice, and also a brief description of the purpose of the program. For example:
0 Все файлы исходники должны начинаться с комментария в стиле С, который дает список программиста(ов), дату, авторские права, а также краткое описание назначения программы. Например:
→3.1.1 Beginning Comments
0 3.1.1. Открывающие комментарии
→* Class and interface declarations (see "Class and Interface Declarations" on page 4)
0 * Объявление классов и интерфейсов (см "Объявление классов и интерфейсов" на стр. 4)
→* Package and Import statements; for example:
0 * Сведения о пакете и импорте; например:
→* Beginning comments (see "Beginning Comments" on page 4)
0 * Открывающие комментарии (см. "Открывающие комментарии" на стр. 4)
→Java source files have the following ordering:
0 Файлы исходники Java имеют следующую структуру:
→Each Java source file contains a single public class or interface. When private classes and interfaces are associated with a public class, you can put them in the same source file as the public class. The public class should be the first class or interface in the file.
0 Каждый файл Java исходника содержит один общий класс или интерфейс. Когда частные классы и интерфейсы связаны с общим классом, вы можете поместить их в том же исходном файле, где находится общий класс. Общий класс должен быть в таком случае первым классом или интерфейсом в файле.
→3.1 Java Source Files
1 3.1. Файлы исходники Java
→For an example of a Java program properly formatted, see "Java Source File Example" on page 19.
2 В качестве примера правильного оформления Java программы, см. "Java Source File Example" на стр. 19.
→Files longer than 2000 lines are cumbersome and should be avoided.
1 Файлы длиннее 2000 строк громоздки и их следует избегать.
→A file consists of sections that should be separated by blank lines and an optional comment identifying each section.
0 Файл состоит из разделов которые должны быть визуально отделены друг от друга пустыми строками и необязательным комментарием, который идентифицирует каждый раздел.
→3 File Organization
1 3. Структура файла
→README |The preferred name for the file that summarizes the contents of a particular directory.
1 README | Предпочтительное имя файла, который суммирует содержимое определенного каталога.
→GNUmakefile |The preferred name for makefiles. We use gnumake to build our software.
0 GNUmakefile | Предпочтительное имя для make-файлов. Мы используем gnumake для сборки нашего программного обеспечения.
Резюме
Пол:
женщина
Родной язык:
русский
С нами:
с 17 июля 2011 г. (5572 дня)
Деятельность:
996 версий перевода с общим рейтингом 154
49 комментариев
Карма: 3 (оценок: 3)
Написать belgita80 личное сообщение