Automatic program documentation

A method of providing object code and program documentation from a source code comprising the steps of:

• a) receiving said source code, said source code including executable source code and source code documentation together in a first sequence;
• and
• b) compiling said received source code by utilizing a processor to generate object code and program documentation from said source code including the steps of:
• i) generating object code from said source code;
• and
• ii) generating, in conjunction with said step of generating object code, program documentation including a plurality of selected portions of said executable source code and said source is code documentation;
• iii) reordering said selected portions into a second predefined sequence independent of and different from said first sequence of said executable source code and source code documentation.

A data processing system comprising a host computer including:

• a) a memory for storing data;
• b) input means for receiving said source code and storing said source code in the memory, the source code including executable source code and source code documentation together in a first sequence;
• and
• d) compilation means, coupled to the input means, including:
• i) first means for generating object code from said source code;
• and
• ii) second means, coupled to said first means, for generating program documentation including selected portions of said executable source code and said source code documentation;
• iii) third means for reordering said selected portions into a second predefined sequence independent of and different from said first sequence of said executable source code and source code documentation.

A data processing system including a computer programming means residing in memory and executed by a processor, said data processing system comprising:

• processing means, instructed by said computer programming means, for compiling and generating object code and program documentation from source code, said source code including-executable source code and source code documentation, said program documentation including said source code documentation and portions of said executable source code together in a first sequence, said processing means including:
• a) first, means for generating object code from said source code;
• and
• b) second means, couple to said first means, for generating program documentation including a plurality of selected portions of said executable source code and said source code documentation;
• c) third means for reordering said selected portions into a second predefined sequence independent of and different from said first sequence of said executable source code and source code documentation.