From: Hal B. <ha...@bu...> - 2002-05-29 02:35:53
|
On Mon, May 27, 2002 at 05:19:58PM +0200, Andreas Oesterhelt wrote: > > > BTW, Andreas did we sync config comments with u-m? I don't think I've > > touched any of that, but not sure if anyone else has. > > No. I had hoped someone would do it, which reminds me of this (old) story: > http://www.nanuq.com/ashleigh/stuff/everybody_somebody_anybody_nobody.html Somebody has done it :) I went ahead and tried to get this as automatic as I could. This required breaking up u-m into config.sgml and p-config.sgml, and some tinkering with the content and mark up a little. But I *think* it does a mostly decent job. There's a make config-file target in Makefile now, that does about a 98% job of it by using w3m and fmt. Still some hand editing required, but not too bad. Per previous discussion on this, lynx does a lousy job. So I wound up using 'fmt' to shorten w3m line lengths so I don't know how portable that is. w3m just is better at this despite lynx having many more available options. Anyway, maybe after 3.0 someone better at perl can further tweak the target. Things needing work to make it fully automated (assuming w3m and fmt are used for final text processing): -I manually adjusted the section numbering. This just needs the first digit dropped. -Some of the examples got mangled, especially Debug levels, forwarding, and Socks stuff. I think w3m handles this well by not breaking lines (lynx breaks them anyway), but fmt scrambles them. -I can't see a way of doing the underlining with '======' for headers, so that was manually done. -- Hal Burgiss |