IEEE P1003.0 Draft 13 - September 1991 Copyright (c) 1991 by the Institute of Electrical and Electronics Engineers, Inc. 345 East 47th Street New York, NY 10017, USA All rights reserved as an unpublished work. This is an unapproved and unpublished IEEE Standards Draft, subject to change. The publication, distribution, or copying of this draft, as well as all derivative works based on this draft, is expressly prohibited except as set forth below. Permission is hereby granted for IEEE Standards Committee participants to reproduce this document for purposes of IEEE standardization activities only, and subject to the restrictions contained herein. Permission is hereby also granted for member bodies and technical committees of ISO and IEC to reproduce this document for purposes of developing a national position, subject to the restrictions contained herein. Permission is hereby also granted to the preceding entities to make limited copies of this document in an electronic form only for the stated activities. The following restrictions apply to reproducing or transmitting the document in any form: 1) all copies or portions thereof must identify the document's IEEE project number and draft number, and must be accompanied by this entire notice in a prominent location; 2) no portion of this document may be redistributed in any modified or abridged form without the prior approval of the IEEE Standards Department. Other entities seeking permission to reproduce this document, or any portion thereof, for standardization or other activities, must contact the IEEE Standards Department for the appropriate license. Use of information contained in this unapproved draft is at your own risk. IEEE Standards Department Copyright and Permissions 445 Hoes Lane, P.O. Box 1331 Piscataway, NJ 08855-1331, USA +1 (908) 562-3800 +1 (908) 562-1571 [FAX] P1003.0/D13 GUIDE TO THE POSIX OPEN SYSTEMS (4) Profiles making identical use of particular base documents shall be consistent, down to the level of identical wording in the POSIX SPs for identical requirements. A.7.2 Multipart POSIX SPs Many profiles will be documented and published as individual POSIX SPs. However, where close relationships exist between two or more profiles, a more appropriate technique can be used. Common text between related profiles is essential to ensure consistency, portability, and interworking, to avoid unnecessary duplication of text, and to aid writers and reviewers of POSIX SPs. A _s_i_n_g_l_e-_p_a_r_t _P_O_S_I_X _S_P shall not contain the definition of more than one profile. The following rules apply to _m_u_l_t_i_p_a_r_t _P_O_S_I_X _S_P_s: (1) A multipart POSIX SP shall contain the definition of a complete profile or of a related set of profiles. (2) A part of a multipart POSIX SP may contain a section of the definition of one or more profiles. (3) Where a multipart POSIX SP includes more than one profile, the part structure shall permit each profile to be the subject of a separate ballot; i.e., its constituent profiles shall be clearly identifiable, and the multipart structure shall ensure that this can be accomplished. (4) Wherever possible, the references made from one part to another should be to complete parts. However, controlled use of one-way references to sections of other parts is permitted in order to obtain a reasonable multipart structure. Because there may also be potential disadvantages from overuse of the multipart POSIX SP capability, such as difficulties in gaining approval for a complex linked set of parts, or reduction of the content of a part to a small amount of text, considerable care should be taken with its use. NOTES: (1) When a section of text appears in several profiles, possibilities exist for sharing the corresponding code (etc.) for the implementation of several profiles, and the tests applicable to the use of the referenced base standards will be applicable to the testing of several profiles. Copyright c 1991 IEEE. All rights reserved. This is an unapproved IEEE Standards Draft, subject to change. 280 A Considerations for Developers of POSIX SPs ENVIRONMENT INTERIM DOCUMENT P1003.0/D13 (2) It follows that it is in the interest of the implementors to promote the identification of common sections of text as parts of POSIX SPs, but even more to promote, in future standardization and profile work, the use of already defined parts of POSIX SPs, so that profiles fall into a few ``common molds.'' In particular, this allows implementation of a part of a POSIX SP with confidence that it may be used in the implementation of profiles as yet undefined, so that products are open to future development. (3) Possibilities exist for a complete profile to be referenced from within the definition of another profile. A.8 Rules for Drafting and Presentation of POSIX SPs Throughout this Annex, which is concerned with documentation content and layout, reference is made to POSIX SPs. A POSIX SP, or part thereof, may contain a whole profile definition or part of one or more profile definitions. The wording of the Annex assumes that it is describing an undivided POSIX SP that defines one profile in its entirety. Its application to the other cases is easily deduced. Note, however, that each part of a Multipart POSIX SP shall use the same format as far as appropriate. A.8.1 General Arrangement The elements that together form a POSIX SP are classified into three groups: (1) Preliminary elements are those elements that identify the POSIX SP, introduce its content, and explain its background, its development, and its relationship with other standards and POSIX SPs. (2) Normative elements are those elements setting out the provisions with which it is necessary to comply in order to be able to claim conformity with the POSIX SP. (3) Supplementary elements are those elements that provide additional information intended to assist the understanding or use of the POSIX SP. These groups of elements are described in the following clauses. Copyright c 1991 IEEE. All rights reserved. This is an unapproved IEEE Standards Draft, subject to change. A.8 Rules for Drafting and Presentation of POSIX SPs 281 P1003.0/D13 GUIDE TO THE POSIX OPEN SYSTEMS A.8.2 Preliminary Elements A.8.2.1 Foreword The foreword shall appear in every POSIX SP. It consists of a general part giving information relating to the organization responsible and a specific part giving as many of the following as are appropriate: - An identification of the organization or committee that prepared the POSIX SP; information regarding the approval of the POSIX SP - A statement that the POSIX SP cancels or replaces other documents in whole or in part - A statement of significant technical changes from the previous edition - A statement of which annexes are normative and which are informative A.8.2.2 Introduction The introduction shall appear in every POSIX SP. It gives specific information about the process used to draft the POSIX SP and about the degree of international harmonization that it has received. A.8.3 General Normative Elements A.8.3.1 Title The title shall be composed of the following three elements: (1) An introductory element: _S_t_a_n_d_a_r_d _f_o_r _I_n_f_o_r_m_a_t_i_o_n _T_e_c_h_n_o_l_o_g_y (2) An identification element: _P_O_S_I_X _S_t_a_n_d_a_r_d_i_z_e_d _P_r_o_f_i_l_e (3) A main element indicating the subject matter of the POSIX SP. For a Multipart POSIX SP, this element shall be subdivided into a general title element common to all parts, and a specific title element for each part; where necessary, this specific element may include the identifier of an individual profile. The first word of this element should be the word ``POSIX''. Example: Copyright c 1991 IEEE. All rights reserved. This is an unapproved IEEE Standards Draft, subject to change. 282 A Considerations for Developers of POSIX SPs