| 1 |
On Friday, June 17, 2011 02:40:27 justin wrote: |
| 2 |
> >> I wasn't aware of that. We are lacking any documentation about the |
| 3 |
> >> proper documentation for manpages in all eclass writing guides. |
| 4 |
> > |
| 5 |
> > the syntax is fully documented in the utility that generates it. see the |
| 6 |
> > awk in the eclass-manpages filesdir. |
| 7 |
> |
| 8 |
> This is not a proper way of documentation. |
| 9 |
|
| 10 |
in your opinion of course. makes perfect sense to me though to have the |
| 11 |
documentation in the exact same file as the code that implements said |
| 12 |
documentation. more likely that the two are kept in sync. |
| 13 |
-mike |
Archives