OASIS logo

OpenOffice Specification Sample

Working Draft 01, 22 December 2003

Document identifier:

spectools-openoffice-sample-draft-01

Location:

http://www.oasis-open.org/spectools

Editor:

[List your editors here, deleting the following example; check whether “Editor” header should be plural]

Eve Maler, Sun Microsystems (eve.maler@sun.com)

Contributors:

[List your contributors here, deleting the following examples and sorting your entries first by affiliation and then by family name]

[Optionally list them in the Acknowledgments appendix instead]

Karl Best, OASIS

Norman Walsh, Sun Microsystems

Abstract:

[Supply your own summary of the technical purpose of the document.] This document provides a working OpenOffice.org sample from which you can start editing your own OASIS-published document. It uses a template called spectools-openoffice-template. Instructions are provided as italic text in brackets, which should be deleted before publication. Full instructions are provided in the body of the document.

Status:

[Describe the status and stability of the specification and where to send comments.]

The following text is boilerplate; to use, fix the hyperlinked text by selecting each blue string and choosing Insert>Hyperlink (Alt+I then Alt+H):] Committee members should send comments on this specification to the xxx@lists.oasis-open.org list. Others should subscribe to and send comments to the xxx-comment@lists.oasis-open.org list. To subscribe, send an email message to xxx-comment-request@lists.oasis-open.org with the word "subscribe" as the body of the message.

[The following text is boilerplate; to use, fix the hyperlinked text:] For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the XXX TC web page (http://www.oasis-open.org/committees/xxx/).

[If a Committee Specification or OASIS Standard:] The errata page for this specification is at http://www.oasis-open.org/committees/xxx/yyy.

Table of Contents

[Insert table of contents here by choosing Insert>Indexes and Tables>Indexes and Tables... and going to the Index/Table tab. Note that a TOC title has already been provided above, so zero out the “Title” field in the dialog box.]

Introduction

[Provide an introductory chapter, indicating if any parts of it are non-normative, as is sometimes the case.]

Terminology

[The following text is boilerplate. Most specifications will need this and the corresponding bibliography entry.] The key words must, must not, required, shall, shall not, should, should not, recommended, may, and optional in this document are to be interpreted as described in IETF RFC 2119 [RFC2119].

Styles

[This section is provided to explain and demonstrate the styles available in the OpenOffice.org template called spectools-openoffice-template that is associated with this sample document. It is important to use the styles provided in the template consistently and to avoid using raw formatting and defining new styles (unless you have a good reason to define new styles and use them consistently). Delete this entire section when using this sample document to begin writing a new specification.]

Overall Style

The paper size is set to Letter, which is 8½ x 11. You may change this to A4 or whatever other size suits your needs, and you may also change the portrait display setting to landscape. You can do this by modifying the default page style (available through the Stylist dialog box; choose Format>Stylist or press F11) or by creating and using new page styles.

The document identifier and publication date information in the footer need to be updated every time you publish.

Line numbers are enabled by default for easy reference by specification commenters. You may turn line numbering off (choose Tools>Line Numbering... and uncheck the Show numbering checkbox).

Title Page

The title page is designed to fit a lot of metadata compactly. If you wish to create a “true” title page, you may insert a page break after the subtitle (choose Insert>Manual Break...).

Headings

Heading 1 through Heading 9, Appendix Heading 1, and Heading unnumbered have been defined with a special appearance. Headings are generally numbered and appear in the Table of Contents. Pressing Return after a heading inserts a Text Body paragraph style directly after.

This template sets these styles to start on a new page. You may set the Heading 1 style (on which the others are based) not to start on a new page if you wish. It produces a horizontal rule above the title text.

Paragraphs

The font in the Text Body paragraph style (as well as the Default style on which it is based) is 10-pt Arial. You may change this to 11-pt Times New Roman if you prefer a serif font; changing this setting should change all the other relevant styles.

Lists

The Definition term and Definition paragraph styles are defined specially for this template. They produce a definition list with a hanging appearance. Pressing Return after one inserts the other directly after.

Definition term

Definition for the term.

Use the List 1 style for top-level unnumbered lists and List 2 for second-level unnumbered lists; tab over to get the proper indent:

Item 1

Item 1a

Item 1b

Item 2

Use the Numbering 1 style for top-level numbered lists:

Numbered item 1

Numbered item 2

For bibliography lists, use the Ref paragraph style. Use the Ref term character style for the bracketed text that serves as the bibliography entry key, tab over to the rest of the entry, and make each reference term into a bookmark for use in references from the text. For example, [RFC2119] is a generated cross-reference to the IETF RFC 2119 bibliography entry in Section 3.1 of this sample.

Tables

Use the following style for tables unless you have a good reason to use a different one:

Heading 1	Heading 2	Heading 3
Contents A1	Contents A2	Contents A3
Contents B1	Contents B2	Contents B3

1.7 Code Examples

For schema code and other normative code, use the Code paragraph style. It fits 72 characters. For example:

123456789012345678901234567890123456789012345678901234567890123456789012

1 2 3 4 5 6 7

Use the Code small style if the code has very long lines. It fits 82 characters. For example:

1234567890123456789012345678901234567890123456789012345678901234567890123456789012

1 2 3 4 5 6 7 8

For non-normative examples, use the Example paragraph style. For example:

GET http://<host name and path>?TARGET=<Target>...<HTTP-Version>

<other HTTP 1.0 or 1.1 components>

Use the Example small style if the example has very long lines. For example:

GET http://<host name and path>?TARGET=<Target>...<HTTP-Version>

<other HTTP 1.0 or 1.1 components>

Character Styles

This template defines several character styles for general text use:

The Element style for <NativeElement> names and <ns:ForeignElement> names; add the angle brackets yourself

The Attribute style for attributeNames

The Datatype style for DataType names

The Keyword style for OtherKeyword names

The Variable style for variable names

References

[You may or may not need separate sections for normative and non-normative references.]

Normative References

[RFC2119]	S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, IETF RFC 2119, March 1997, http://www.ietf.org/rfc/rfc2119.txt.

Acknowledgments

[This appendix is optional, but often provided. Sort names by affiliation and then by family name.] The editors would like to acknowledge the contributions of the OASIS XXX Technical Committee, whose voting members at the time of publication were:

John Doe, Foo Corporation

In addition, the following people made contributions to this specification:

Jane Doe, Bar Inc.

Revision History

[This appendix is optional, but helpful. It should be removed for specifications that are at OASIS Standard level. Set the number format for the Rev and Date fields as you wish (select the desired string and choose Format>Number Format...); the examples below are user-defined formats.]

Rev	Date	By Whom	What
01	22 Dec 2003	Eve Maler	An initial customized OpenOffice.org sample using the new spectools-openoffice-template template.

Notices

OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS's procedures with respect to rights in OASIS specifications can be found at the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification, can be obtained from the OASIS Executive Director.

OASIS invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to implement this specification. Please address the information to the OASIS Executive Director.

Copyright © OASIS Open 2004. All Rights Reserved.

This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself does not be modified in any way, such as by removing the copyright notice or references to OASIS, except as needed for the purpose of developing OASIS specifications, in which case the procedures for copyrights defined in the OASIS Intellectual Property Rights document must be followed, or as required to translate it into languages other than English.

The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.

This document and the information contained herein is provided on an “AS IS” basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

spectools-sample-openoffice-draft-01	22 December 2003

Copyright © OASIS Open 2004. All Rights Reserved.	Page 9 of 9

Eve Maler

2003-10-12T14:53:37