| 1 |
>>>>> "D" == Duncan <1i5t5.duncan@×××.net> writes: |
| 2 |
|
| 3 |
D> While you're correct in the ordinary case, keep in mind that this is perl |
| 4 |
D> developer docs we're talking about here -- not ordinary user documentation. |
| 5 |
|
| 6 |
Developer docs *are* ordinary user documentation. Section 3 is perhaps |
| 7 |
the most used section of man, with sections 2 and, depending on platform, |
| 8 |
one or more of sections 4, 5 or 6 following. |
| 9 |
|
| 10 |
D> And those that know enough about perl to find the developer documentation |
| 11 |
D> useful should also know how to use perldoc, |
| 12 |
|
| 13 |
You are ignoring the fact that having the docs in man is more useful; |
| 14 |
much easier to use, usable by any man reader. The list goes on. |
| 15 |
|
| 16 |
There is simply no *real* benefit to eliding them, it only does harm. |
| 17 |
|
| 18 |
People who do not want to install them should specify that preference |
| 19 |
via a USE flag (-man, perhaps). |
| 20 |
|
| 21 |
It would even be OK were the USE flag off by default; but making it |
| 22 |
impossible to Do The Right Thing w/o editing eclasses every time one |
| 23 |
syncs is just wrong. |
| 24 |
|
| 25 |
-JimC |
| 26 |
-- |
| 27 |
James Cloos <cloos@×××××××.com> OpenPGP: 1024D/ED7DAEA6 |
Archives