H  3GPP styles and various information  Word‑p. 45

H.1  The 3GPP styles

Use table H.1 when determining which style to use for various elements of the deliverable.

Table H.1

Use this style

For this type of element

---

Heading 1

Clause (→ if numbered)

Heading n

Clause level n

In exceptional cases, for level 6 or beyond, use Heading 5 if required in contents list or H6 if not to appear. →

Heading 8

Annex title for TS

Heading 9

Annex title for TR

Normal

Standard paragraph, Definition

EX

Reference, Example →

EW

Symbol, Abbreviation, Example continuation in text →

Bn

List element level n →

FP

Free paragraph (left justified)

NO

Note integrated in the text →

NW

Note continuation in text →

NF

Note in figure →

TAN

Note in table →

TH

Table title, Figures

TAH

Heading within table

TAC

Centred text within table

TAL

Left justified text within table

TAR

Right justified text within table

TF

Figure title

TT

Contents list title

PL

Programming language

EQ

Equation

Header

Header (portrait and landscape pages)

---

→ use "tab" between "item/number" and "text".

EXAMPLE:

The "tab" is preceding this example text.

---

Other styles exist in the template, but are for use by the Support Team only.

H.2  Page numbering, page headers and footers

The skeleton document supplies fields for automatic page numbering and the identification of the deliverable in the page header. Do not add anything to or delete anything from the headers.

• Use the HEADER style on all page headers (sections) except for the title page (section)

H.3  Configuration of the Windows environment  Word‑p. 46

Set your Windows environment to use the English (International) conventions (via Control Panel, International).

• Use centimetres as the preferred unit of measurement.
• Do not select "Change 'Straight Quotes' to 'Smart Quotes'" in the AutoCorrect options.
• Set Default Tab Stops to 0,5 cm.
• The remaining configurable elements of Windows and of Word are at your discretion.

H.4  Sequence numbering

You may use sequence numbering (Insert Field Seq) for tables, figures, equations, references, etc. Use the sequence identifiers shown in the following table.

Table H.2: Sequence numberings

Sequence

Bookmark name

Description

---

seq bib

bib_xx

for bibliography entries

seq equ

equ_xx

for equations (note 1)

seq fig

fig_xx

for figures (note 1)

seq ref

ref_xx

for references

seq tab

tab_xx

for tables (note 1)

---

NOTE 1:

Reset the sequence numbering to one for the first item of each annex of a 3GPP TS or 3GPP TR by using the switch \r1 (e.g. { seq fig \r1 }).

NOTE 2:

"xx" represents the identifier for the particular object concerned, e.g. fig_ProcessControl. Do not use bookmarks of the form "fig_fig1". You can use underscores as separators in sequence identifiers if necessary.

---

Thus the title of a table will read:

Table { seq tab }: Table title

where the italic part represents the sequence field code.

Bookmark each entry in a sequence (select it and use Edit Bookmark Add), using a bookmark name of the form shown in table H2. You can then refer to the table, figure, reference, etc. from the text by inserting a sequence field citing the same sequence identifier and the particular bookmark required. For example, table 1 has been bookmarked "tab_Seq_Num". Thus a reference to this table from the text reads:

… see table { seq tab tab_Seq_Num } …

where the italic part represents the sequence field code.

You can force Word to recalculate and refresh the display of sequence numbers and their references by selecting the text and pressing F9.

Do not use Word's cross-referencing tool (Insert, Cross-reference), since it implies the use of automatic heading or caption numbering.

When drafting is complete and the TS or TR is ready to be presented to the TSG for placing under change control, hard code all automatic number sequences (Ctrl-Shift-F9) that might have been used. Thereafter, manual numbering shall be used. This will avoid invalidating references from extermal documents to particular clauses / tables / etc. in the document under consideration (see clause 5.2.1A).

You may use automatic clause numbering during the drafting phase of a TS or TR, but automatic clause numbering shall be disabled for a TS or TR under change control.

H.5  Supported file formats  Word‑p. 47

Software tools to be used for document development within 3GPP are detailed in table H.3

Table H.3: Permitted software tools

Type

Tool(s)

Comments

---

Text

Microsoft Word.
Note:
For .doc format, file compatibility with Word 2000 shall be retained for 3GPP TSs and TRs.
For .docx format, file compatibility with Word 2007 shall be retained for 3GPP TSs and TRs.

Word's built-in equation editor, or Microsoft MathType
Note: Used for editing equations.

Graphics

Micrografx Designer version 3.x or 6.0 or 7.0 (preferred)

Now part of CorelDraw, but older versions can be found for download.
Retained for legacy documents. Not to be used for new graphics.

MS Visio (file compatibility with version Professional 2003 or 2007shall be maintained)

For general graphics; the rapporteur shall supply the source file.

Microsoft Word built-in drawing tools.

Final diagrams shall be visible in "normal" view (Word 2003 and earlier) or "draft" view (Word 2007 and later).

For Unified Modeling Language (UML) graphics: Eclipse Papyrus (http://www.eclipse.org/papyrus/)

Many earlier UML diagrams have been supplied as uneditable JPGs. For ease of maintenance, rapporteurs should provide editable source files for new UML diagrams, and authors of CRs are encouraged to recast UML diagrams originally supplied as JPGs to Papyrus in order to ease future maintenance.

SDL, MSC

IBM Telelogic Tau

SDL diagrams and Message Sequence Charts can be copy-and-pasted into Word. Rapporteurs shall supply the source files.
Note 1: Rapporteurs should contact their Support Team officer for access to this tool.
Note 2: For SDLs, Microsoft Visio (see above) may be used.
Note 3: Retained for legacy documents. Not to be used for new documents.

Msc-generator

Available from https://sourceforge.net/projects/msc-generator/

User manual at http://msc-generator.sourceforge.net/help/6.3/msc-gen.pdf

TTCN-2

Any TTCN-2 tool that is compliant with ISO/IEC 9646 [4]

Note: Rapporteurs may contact their Support Team officer for access to a tool.

TTCN-3

Any TTCN-3 tool that is compliant with ETSI ES 201 873 [5]

Note: Rapporteurs may contact their Support Team officer for access to a tool.

Databases

Microsoft Access.
Note: File compatibility with Access 2000 or 2007 shall be maintained.

Such databases are used principally by the Support Team for management and tracking purposes.

General Tools

Microsoft Office software suite (Excel, Powerpoint, etc.)
Note: File compatibility with Office version 2000 or 2007 shall be maintained if such documents form part of TSs or TRs.

---

The file formats stipulated in table H.3 relating to Microsoft© Office refer strictly to the file format. It is not intended to mandate that a particular version of MS Office or MS Office compatible software be used: any word processor which can save files in the above format is acceptable.

Rapporteurs shall retain the source files of graphics where these exist, and they shall be retained within the zip file of the Spec for future maintenance of the document.

H.6  Quick tips to working with your document  Word‑p. 49

When working with your 3GPP TS or 3GPP TR remember…

… you shall do this…

• use bold to emphasize text;
• use italic for citations, linguistic expressions or when a word/text/expression is extracted from a specific context;
• use non-breaking spaces (°) or hyphens (‑) in order to avoid unexpected wrap around between two words and/or numbers (e.g. 50°cm, 1°000, clause°6, annex°A, table°1, figure°1, TR°21°801‑1, etc.). These characters appear as normal spaces ( ) or hyphens (-) when printed out;
• use the default tab stops 0,5 cm;
• use "straight" quotation marks (". . .") not "curly" or "smart" (". . .") ones. If a second set of quotations is needed (e.g. GDMO, ASN.1, etc.), single quotes ('. . .') may be used.

… but you shall not do this…

• alter existing styles or formats pre-set in the 3GPP template;
• add new styles to the 3GPP template;
• delete 3GPP styles;
• use a font other than the one pre-set in the 3GPP styles;
• put more than one space after a full stop;
• precede comma (,), semicolon (;), colon (:), full stop (.), question mark (?) or exclamation mark (!) by spaces;
• use spaces in place of tabs when indentation/alignment is required; this can cause text to be misaligned;
• use footnotes or end-notes;
• unnecessarily use capital letters;
• use underlining to emphasize text (this can be confused with revision marking; see also clause H.7.1).
• use "curly" or "smart" (". . .") quotes.

H.7  Other formatting considerations

H.7.1  Text decoration

It is permissible to use italic and/or bold font for the purposes described in clause H.6.

The use of underlining shall be restricted to the special case where a TS or TR cites text from an external source but makes changes to it; those changes are marked by underlining of newly inserted text and strikeout of text to be deleted. See annex J.3.Underlining shall not be used in any other circumstances due to the risk of confusion with revision marks.

Coloured text shall not be used in TSs and TRs. The text colour shall be left as "automatic" which is normally rendered as black (but may vary depending on the user's setup).

Other text decoration such as highlighting, blinking, shadow, embossed, etc shall not be used.

H.7.2  Colours within figures  Word‑p. 50

It is acceptable to use colours for both graphic elements and text within figures, since this use cannot be confused with revision marks, where the whole figure is replaced rather than elements within the figure.

---