Service Manuals, User Guides, Schematic Diagrams or docs for : xerox sdd memos_1977 19770211_Programming_Conventions

<< Back | Home

Most service manuals and schematics are PDF files, so You will need Adobre Acrobat Reader to view : Acrobat Download Some of the files are DjVu format. Readers and resources available here : DjVu Resources
For the compressed files, most common are zip and rar. Please, extract files with Your favorite compression software ( WinZip, WinRAR ... ) before viewing. If a document has multiple parts, You should download all, before extracting.
Good luck. Repair on Your own risk. Make sure You know what You are doing.




Image preview - the first page of the document
19770211_Programming_Conventions


>> Download 19770211_Programming_Conventions documenatation <<

Text preview - extract from the document
                                                                       J..s jecfreJO>\S
                                                              Qt> M1l1fe
                                                                 ~1'ZlM. 1 ( h;.
                                                                                      /'
                 Inter-Office Memorandum - DRAFf

To:              Distribution                               Date: February 11, 1977


From:            C. Irb~, T. Shetler, and C. Simonyi


Subject:         Programming Conventions                    Organization: SDD/SD


Keywords:        Programming Conventions, Policies, Procedures           XEROX SDD ARCHIVES
                                                                   I have read and understood
                                                                                  To
Filed on:        tonimemo.bravo on Toni Pack One
                                                                  Pages
                                                                 Rev1ewer _________ Date   -----
                                                                 # of Pages
                                                                                              ----
                                                                                      Ref' . 17$1)-3'7:;;
Attached is the draft of the Programming Conventions subsection (2.2) of the Software
Development Procedur~s section of the SOD Policies and Procedures document.

The concept of a Programmer's Notebook is introduced in the attached subsection and refers to
the collection of reference and training materials that every programmer in SD should have.
While this notebook is not intended to replace any existing or planned documentation, it is
considered a necessary repository for related memorandum, notes, etc. The outline and content
of this notebook is not discussed here because it is more appropriately addressed in the context
of training or reference materials for the staff than in a discussion of programming conventions,
though materials that are described as in the Programmer's Notebook will simply be attachmt!nts
that follow the subsection. The exception is the reference to good coding examples which are
still being sought. A "Programmer's Notebook" already exists whether it is in a formal format
or in a form each individual defines for himself. (Perhaps someone already has created such an
object for himself and with a few modifications, we could adopt it for SD?)

Please read, use, and prepare comments on these Programming Conventions. We would like to
have the first final form of this document available for general distribution by the end of
February. If you have any questions, please contact one of us. There will be a meeting during
the week of February 28th to review comments based on your trial use of these conventions.

Distribution:

      B. Ayres
      G. Benedict
      L. Bergsteinsson
      I. Clark
      D. DeSantis
      J. Francleen
      E. Harslem
      P. Heinrich
                   2


R. Johnsson
D. Liddle
M. Lorous
B. Malasky
W. Maybury
 R. Metcalfe
B. Parsley
R. Purvy
W. Shultz
  R. Sonderegger
D. Stottlemyre
R. Sweet
J. Sz~long
C. Thacker
T. Townsend
D. Wallace
J. Wick
                                                                                                         3



2.0 SOFTWARE DEVELOPMENT PROCEDURES

2.1    Documentation Conventions


      This section will be completed at another time with another set of text.

2.2 Programming Conventions


      Introduction:


      The purpose of these conventions is to support the software generation effort so the code
      produced will:

         o Facilitate the creation of the software components of the OIS products.

         o   Be portable among the technical staff.

         o   Be extensible and maintainable over the life of the product.

         In addition, we expect these conventions to be easy to train new staff members to use.

      The conventions presented are, for the most part, not a radical deviation from many
      practices of our experienced staff, nor do they diverge dramatically from the literature on
      accepted software engineering conventions and practices.       Adherence to this set of
      conventions is expected to have long-term gains in the development and on-going
      maintenance of software that should offset any short-run setbacks that result from
      modifying existing code, modifying work habits, or adjusting to different coding rules.

      The three areas of programming conventions described are: format conventions, naming
      conventions, and coding conventions. The concept of general and special conventions
      underlies the description of these Programming Conventions. QflJ.f!.f!.L~Q!1Y.f!1UQ!1



◦ Jabse Service Manual Search 2024 ◦ Jabse PravopisonTap.bg ◦ Other service manual resources online : FixyaeServiceinfo