Re: problems in one or more man pages you maintain

2004-08-02 Thread Dave Shield

esr Note: This patch does not change the mod date of the manual page.  You
esr may wish to do that by hand.
 
Wes Err...  that manual page is auto generated from doxygen.  Adding in
Wes the .SH token will get it overwritten by future doxygen extraction...

Yes - I was looking at this report last week,
and even started ploughing through the doxygen source
to see how these particular man pages are generated.
(Without much luck)

I note that the normal man pages that doxygen spits out look
reasonable (though I'd like to tweak the descriptions at some point).
It's just these specials (todo, deprecated and probably bug) that
seem to be malformed in this manner.

I'd suggest that the simplest thing would be either to drop these
particular man pages from the distribution, or else have a special
sed (or similar) script to paste in the missing formatting.

Dave



---
This SF.Net email is sponsored by OSTG. Have you noticed the changes on
Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now,
one more big change to announce. We are now OSTG- Open Source Technology
Group. Come see the changes on the new OSTG site. www.ostg.com
___
Net-snmp-coders mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders


Re: problems in one or more man pages you maintain

2004-08-02 Thread Wes Hardaker
 On Mon, 02 Aug 2004 10:07:55 +0100, Dave Shield [EMAIL PROTECTED] said:

Dave I'd suggest that the simplest thing would be either to drop these
Dave particular man pages from the distribution, or else have a special
Dave sed (or similar) script to paste in the missing formatting.

Well, I doubt we need to install them by default if its just those
particular man pages...

sigh.  I think there is a reason we try to not rely on many external
packages as they keep breaking ours :-(

-- 
Wes Hardaker
Sparta


---
This SF.Net email is sponsored by OSTG. Have you noticed the changes on
Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now,
one more big change to announce. We are now OSTG- Open Source Technology
Group. Come see the changes on the new OSTG site. www.ostg.com
___
Net-snmp-coders mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders


Re: problems in one or more man pages you maintain

2004-08-02 Thread Eric S. Raymond
Dave Shield [EMAIL PROTECTED]:
 I note that the normal man pages that doxygen spits out look
 reasonable (though I'd like to tweak the descriptions at some point).
 It's just these specials (todo, deprecated and probably bug) that
 seem to be malformed in this manner.
 
 I'd suggest that the simplest thing would be either to drop these
 particular man pages from the distribution, or else have a special
 sed (or similar) script to paste in the missing formatting.

I think those three pages would not be much of a loss.  
-- 
a href=http://www.catb.org/~esr/;Eric S. Raymond/a


---
This SF.Net email is sponsored by OSTG. Have you noticed the changes on
Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now,
one more big change to announce. We are now OSTG- Open Source Technology
Group. Come see the changes on the new OSTG site. www.ostg.com
___
Net-snmp-coders mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders


Re: problems in one or more man pages you maintain

2004-07-28 Thread Wes Hardaker
 On Thu, 22 Jul 2004 14:32:10 -0400, [EMAIL PROTECTED] said:

esr Note: This patch does not change the mod date of the manual page.  You
esr may wish to do that by hand.

Err...  that manual page is auto generated from doxygen.  Adding in
the .SH token will get it overwritten by future doxygen extraction...

-- 
Wes Hardaker
Sparta


---
This SF.Net email is sponsored by BEA Weblogic Workshop
FREE Java Enterprise J2EE developer tools!
Get your free copy of BEA WebLogic Workshop 8.1 today.
http://ads.osdn.com/?ad_id=4721alloc_id=10040op=click
___
Net-snmp-coders mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders


problems in one or more man pages you maintain

2004-07-23 Thread esr
This is automatically generated email about problems in a man page for which
you appear to be responsible.  If you are not the right person or list, tell
me and I will attempt to correct my database.

See http://catb.org/~esr/doclifter/problems.html for details on how and
why these patches were generated.  Feel free to email me with any questions.

Note: This patch does not change the mod date of the manual page.  You
may wish to do that by hand.

Problems with netsnmp_deprecated.3:

1. Section or macro out of place; this confuses translators.

--- netsnmp_deprecated.3-orig   2004-07-22 14:25:17.149556720 -0400
+++ netsnmp_deprecated.32004-07-22 14:25:47.186990336 -0400
@@ -2,7 +2,8 @@
 .ad l
 .nh
 .SH NAME
-deprecated \- Deprecated List
+deprecated \- deprecated entry points
+.SH DESCRIPTION
 .IP Global \fBnetsnmp_add_list_data\fP(netsnmp_data_list **head, netsnmp_data_list 
*node)  1c
 use netsnmp_data_list_add_node instead
 .PP

--
 Eric S. Raymond


---
This SF.Net email is sponsored by BEA Weblogic Workshop
FREE Java Enterprise J2EE developer tools!
Get your free copy of BEA WebLogic Workshop 8.1 today.
http://ads.osdn.com/?ad_id=4721alloc_id=10040op=click
___
Net-snmp-coders mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/net-snmp-coders