Re: Writing manpages (was: Re: Man and UTF-8.)

2009-12-21 Thread Leslie H. Watter
Hi Rogério, Em Wed, Nov 18, 2009 at 07:33:22AM -0200, Rogério Brito escreveu: | Date: Wed, 18 Nov 2009 07:33:22 -0200 | From: Rogério Brito | To: debian-mentors@lists.debian.org | Subject: Re: Writing manpages (was: Re: Man and UTF-8.) | | I guess that I only have two options left, as it seems

Re: Writing manpages (was: Re: Man and UTF-8.)

2009-11-28 Thread Peter Pentchev
On Wed, Nov 18, 2009 at 05:30:33AM -0200, Rogerio Brito wrote: > On Nov 17 2009, Roger Leigh wrote: > > However, TTBOMK UTF-8 manpages should be OK as well, though I have > > found some issues with more esoteric characters. I would suggest > > reporting bugs or contacting the maintainer or groff u

Re: Writing manpages: patch submitted to Developers Reference.

2009-11-20 Thread Charles Plessy
Dear all, I submitted the attached patch as bug #557298. Thanks to everybody who contributed to this thread, and have a nice week-end! -- Charles Index: best-pkging-practices.dbk === --- best-pkging-practices.dbk (révision 6986) +++

Re: Writing manpages

2009-11-19 Thread Ben Finney
Charles Plessy writes: > Le Thu, Nov 19, 2009 at 11:14:10AM +1100, Ben Finney a écrit : > > Now if only we can convince more package maintainers. Hopefully the > > ability to use these source formats, with steady evangelisation > > about the available rendering tools, can lower the resistance to

Re: Writing manpages (was: Re: Man and UTF-8.)

2009-11-19 Thread Charles Plessy
Le Wed, Nov 18, 2009 at 05:30:33AM -0200, Rogério Brito a écrit : > > But what do you people use to edit manpages that you maintain > frequently? Dear Rogério, I found jEdit (http://www.jedit.org/) quite convenient to write and modify Docbook XML manpages. It is not packaged in Debian, but Upstr

Re: Writing manpages

2009-11-19 Thread Charles Plessy
Le Thu, Nov 19, 2009 at 11:14:10AM +1100, Ben Finney a écrit : > > Now if only we can convince more package maintainers. Hopefully the > ability to use these source formats, with steady evangelisation about > the available rendering tools, can lower the resistance to following > policy on providin

Re: Writing manpages

2009-11-18 Thread Felipe Sateler
Ben Finney wrote: The Fungi writes: I, too, had resolved recently to start maintaining all my project documentation in reST. Not that I find building/editing manpages directly in vi to be that hard, but it's still laborious and time-consuming. I'll be happy to contribute fixes to this for any

Re: Writing manpages

2009-11-18 Thread Ben Finney
The Fungi writes: > I, too, had resolved recently to start maintaining all my project > documentation in reST. Not that I find building/editing manpages > directly in vi to be that hard, but it's still laborious and > time-consuming. I'll be happy to contribute fixes to this for any bugs > I find

Re: Writing manpages

2009-11-18 Thread Rogério Brito
Hi, Russ. On Nov 18 2009, Russ Allbery wrote: > Yup. :) And there's a nice Emacs mode for POD that does coloration > and whatnot. (There is for *roff as well, but I hate typing *roff > directly.) Well, it seems that we have two strong contenders: POD and reST. Things look brighter for a more do

Re: Writing manpages

2009-11-18 Thread The Fungi
On Wed, Nov 18, 2009 at 08:56:10PM +1100, Ben Finney wrote: > Type the page as a reStructuredText document, then render it to a > manpage with ‘rst2man’ [...] Awesome! This thread already had me thinking, "There should be a reST to TROFF/GROFF path--if there's not I guess I'll write one." I, too,

Re: Writing manpages

2009-11-18 Thread Paul Wise
On Wed, Nov 18, 2009 at 6:23 PM, Joachim Wiedorn wrote: > I have checked the repository: >  * manedit is in Lenny and Squeeze manedit has been removed from squeeze since February. >  * gmanedit is only in Etch and Squeeze > > Now I have installed the Squeeze version of gmanedit. And I must say:

Re: Writing manpages

2009-11-18 Thread Joachim Wiedorn
Hello, Am Wed, 18 Nov 2009 07:33:22 -0200 wrote Rogério Brito : > > I find the simplest way is to use *ManEdit*. > > Is this the same as gmanedit (that's the only one that seems to be > available in the archives)? I remember having used it some ages ago and > I wasn't impressed, but that wa

Re: Writing manpages

2009-11-18 Thread Russ Allbery
Rogério Brito writes: > OK, since the project strongly advises for the availability of manpages > (and I love manpages), comes the question: what do you people use to > type manpages? POD. But then, I wrote the tools that convert POD to *roff, so I would. > The best so far that I found seems t

Re: Writing manpages

2009-11-18 Thread Ben Finney
Rogério Brito writes: > OK, since the project strongly advises for the availability of > manpages (and I love manpages), comes the question: what do you people > use to type manpages? Type the page as a reStructuredText document, then render it to a manpage with ‘rst2man’ http://packages.debian.

Re: Writing manpages (was: Re: Man and UTF-8.)

2009-11-18 Thread Paul Wise
2009/11/18 Rogério Brito : > On Nov 18 2009, Joachim Wiedorn wrote: >> I find the simplest way is to use *ManEdit*. > > Is this the same as gmanedit (that's the only one that seems to be > available in the archives)? I remember having used it some ages ago and > I wasn't impressed, but that was a l

Re: Writing manpages (was: Re: Man and UTF-8.)

2009-11-18 Thread Rogério Brito
Hi, Joachim. On Nov 18 2009, Joachim Wiedorn wrote: > Am Wed, 18 Nov 2009 05:30:33 -0200 schrieb Rogério Brito : > > But what do you people use to edit manpages that you maintain > > frequently? > I find the simplest way is to use *ManEdit*. Is this the same as gmanedit (that's the only one that

Re: Writing manpages (was: Re: Man and UTF-8.)

2009-11-17 Thread Joachim Wiedorn
Hello, Am Wed, 18 Nov 2009 05:30:33 -0200 schrieb Rogério Brito : > But what do you people use to edit manpages that you maintain > frequently? I find the simplest way is to use *ManEdit*. At the beginning you can get templates for the structure of the man page. There are support for heade