Datum: Wed, 26 Jul 2006 17:29:28 +0200 Von: Martin Schulze <[EMAIL PROTECTED]> An: Paul LeoNerd Evans <[EMAIL PROTECTED]> Betreff: Bug#379829: manpages: regex(7) is practically unreadable - offer of rewrite
> Paul LeoNerd Evans wrote: > > I have been using regexps for about 4 years now, and even I can't > > understand regex(7). > > > > I therefore propose a rewrite, to be much longer, a much gentler > > introduction for people who don't understand them, to include plenty of > > examples to illustrate, and generally improve the whole thing. > > > > I've not done a great amount of manpage writing before, other than lots > > of POD in perl code, that gets translated. But I have a far amount of > > experience at writing documentation on code (API docs), and lots of > > experience at using REs. People I meet on IRC say they've learned more > > from a 30second 5line rant of mine than in the entire manpage. > > > > Perhaps I could write a replacement for debian? > > I'd rather like you to get in touch with Michael Kerrisk, so that > the resulting page will pass his quality checks and can be included > in the upstream man-pages package as well instead of a local Debian > version. Paul, Joey, I agree that regex(7) could use a lot of improvement. I'd be prepared to accept a well written replacement. (While doing this, it would be a good idea to read the POSIX regex specification closely.) Cheers, Michael -- Michael Kerrisk maintainer of Linux man pages Sections 2, 3, 4, 5, and 7 Want to help with man page maintenance? Grab the latest tarball at ftp://ftp.win.tue.nl/pub/linux-local/manpages/, read the HOWTOHELP file and grep the source files for 'FIXME'. -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
