| 1 | = Add Prototypes to POSIX Users Guide = |
| 2 | |
| 3 | [[TOC(GCI/Documentation/AddPrototypesToPOSIXUsersGuide, depth=2)]] |
| 4 | |
| 5 | Prerequisite: Being able to build RTEMS Documentation |
| 6 | |
| 7 | The POSIX Users Guide has sections where the prototype of the method |
| 8 | is missing. This is because the current contents for that service are |
| 9 | a stub. The following is an example from |
| 10 | posix_users/device_and_class_specific.rst: |
| 11 | |
| 12 | {{{ |
| 13 | .. code-block:: c |
| 14 | |
| 15 | int tcgetpgrp( |
| 16 | ); |
| 17 | }}} |
| 18 | |
| 19 | This task consists of finding all methods in the .rst file specific to your instance of the task, locating all places where a method is incompletely prototyped, finding the correct prototype, fixing the document, and submitting a patch. The correct prototype can be found in the Open Group POSIX specification at http://pubs.opengroup.org/onlinepubs/9699919799/ |
| 20 | |
| 21 | For the above example, the correct prototype you would end up with should be: |
| 22 | |
| 23 | {{{ |
| 24 | .. code-block:: c |
| 25 | |
| 26 | #include <unistd.h> |
| 27 | pid_t tcgetpgrp(int fildes); |
| 28 | }}} |
| 29 | |
| 30 | The expected output for this task is a patch against rtems-docs which adds all missing prototypes to a single file. The mentor should ensure the patch does add all missing prototypes to the patched file and that the documentation builds. If the mentor has commit privileges, they can commit the patch. |
| 31 | |
| 32 | == Set of Files Missing Prototypes == |
| 33 | |
| 34 | When this task was initially identified, the following was used to determine which files needed attention: |
| 35 | |
| 36 | {{{ |
| 37 | posix-users]$ grep -Pzl "\(\n \);" *.rst |
| 38 | device_and_class_specific.rst |
| 39 | input_and_output.rst |
| 40 | language_specific_services.rst |
| 41 | memory_managment.rst |
| 42 | system_database.rst |
| 43 | thread_cancellation.rst |
| 44 | }}} |
| 45 | |
| 46 | |
| 47 | |