public inbox for docbook-tools-discuss@sourceware.org
 help / color / mirror / Atom feed
* Creating man pages from Docbook - docbook2man does not generate man pages.
@ 2003-11-17 17:06 Hans Deragon
  2003-11-17 17:17 ` Tim Waugh
  0 siblings, 1 reply; 5+ messages in thread
From: Hans Deragon @ 2003-11-17 17:06 UTC (permalink / raw)
  To: docbook-tools-discuss

Greetings.


   Newbie here with docbook.  Docbook is easy and I get docbook2pdf, docbook2ps 
and docbook2html working marvelously.  However, when I run docbook2man, only the 
following two files are created:

-rw-r--r--    1 qhander  qhander         0 Nov 17 11:11 manpage.links
-rw-r--r--    1 qhander  qhander        27 Nov 17 11:11 manpage.refs

   There is no real man page created.  I search for the web for some HowTos, but 
no success.  What is missing to generate man pages?

   I am running docbook version 3.1-3.


Best regards,
Hans Deragon
--
Consultant en informatique/Software Consultant
Deragon Informatique inc.         Open source:
http://www.deragon.biz            http://swtmvcwrapper.sourceforge.net
mailto://hans@deragon.biz         http://autopoweroff.sourceforge.net

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
  2003-11-17 17:06 Creating man pages from Docbook - docbook2man does not generate man pages Hans Deragon
@ 2003-11-17 17:17 ` Tim Waugh
  2003-11-17 17:31   ` Hans Deragon
  0 siblings, 1 reply; 5+ messages in thread
From: Tim Waugh @ 2003-11-17 17:17 UTC (permalink / raw)
  To: Hans Deragon; +Cc: docbook-tools-discuss

[-- Attachment #1: Type: text/plain, Size: 628 bytes --]

On Mon, Nov 17, 2003 at 12:04:53PM -0500, Hans Deragon wrote:

>   Newbie here with docbook.  Docbook is easy and I get docbook2pdf, 
>   docbook2ps and docbook2html working marvelously.  However, when I run 
> docbook2man, only the following two files are created:
> 
> -rw-r--r--    1 qhander  qhander         0 Nov 17 11:11 manpage.links
> -rw-r--r--    1 qhander  qhander        27 Nov 17 11:11 manpage.refs
> 
>   There is no real man page created.  I search for the web for some HowTos, 
>   but no success.  What is missing to generate man pages?

Perhaps you don't have any <refentry> elements?

Tim.
*/

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
  2003-11-17 17:17 ` Tim Waugh
@ 2003-11-17 17:31   ` Hans Deragon
  2003-11-17 17:40     ` Tim Waugh
  0 siblings, 1 reply; 5+ messages in thread
From: Hans Deragon @ 2003-11-17 17:31 UTC (permalink / raw)
  Cc: docbook-tools-discuss

Tim Waugh wrote:
> On Mon, Nov 17, 2003 at 12:04:53PM -0500, Hans Deragon wrote:
> 
> 
>>  Newbie here with docbook.  Docbook is easy and I get docbook2pdf, 
>>  docbook2ps and docbook2html working marvelously.  However, when I run 
>>docbook2man, only the following two files are created:
>>
>>-rw-r--r--    1 qhander  qhander         0 Nov 17 11:11 manpage.links
>>-rw-r--r--    1 qhander  qhander        27 Nov 17 11:11 manpage.refs
>>
>>  There is no real man page created.  I search for the web for some HowTos, 
>>  but no success.  What is missing to generate man pages?
> 
> 
> Perhaps you don't have any <refentry> elements?
> 
> Tim.
> */

Thanks for the tip, but could you point me to a howto for creating man pages 
with docbook?  Is it actually possible from a same docbook xml to create man 
pages and a normal pdf document?  Or must I have one special docbook for man 
pages and another one for the other formats?  Ideally, I want to be able to 
generate a nice PDF manual and a man page from the same source, without having 
to duplicate text.


Sincerely,
Hans Deragon
--
Consultant en informatique/Software Consultant
Deragon Informatique inc.         Open source:
http://www.deragon.biz            http://swtmvcwrapper.sourceforge.net
mailto://hans@deragon.biz         http://autopoweroff.sourceforge.net

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
  2003-11-17 17:31   ` Hans Deragon
@ 2003-11-17 17:40     ` Tim Waugh
  2003-11-17 18:29       ` John Fleck
  0 siblings, 1 reply; 5+ messages in thread
From: Tim Waugh @ 2003-11-17 17:40 UTC (permalink / raw)
  To: Hans Deragon; +Cc: docbook-tools-discuss

[-- Attachment #1: Type: text/plain, Size: 781 bytes --]

On Mon, Nov 17, 2003 at 12:30:40PM -0500, Hans Deragon wrote:

> Thanks for the tip, but could you point me to a howto for creating
> man pages with docbook?  Is it actually possible from a same docbook
> xml to create man pages and a normal pdf document?  Or must I have
> one special docbook for man pages and another one for the other
> formats?  Ideally, I want to be able to generate a nice PDF manual
> and a man page from the same source, without having to duplicate
> text.

What do you mean by 'normal pdf document'?  PDF format output for
refentry looks a lot like you would expect man pages to appear, since
that is how a refentry is structured.  You can of course have filling
text in between refentry elements, or as an introduction, or whatever
if you wish.

Tim.
*/

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: Creating man pages from Docbook - docbook2man does not generate man pages.
  2003-11-17 17:40     ` Tim Waugh
@ 2003-11-17 18:29       ` John Fleck
  0 siblings, 0 replies; 5+ messages in thread
From: John Fleck @ 2003-11-17 18:29 UTC (permalink / raw)
  To: Tim Waugh; +Cc: Hans Deragon, docbook-tools-discuss

On Mon, Nov 17, 2003 at 05:40:05PM +0000, Tim Waugh wrote:
> On Mon, Nov 17, 2003 at 12:30:40PM -0500, Hans Deragon wrote:
> 
> > Thanks for the tip, but could you point me to a howto for creating
> > man pages with docbook?  Is it actually possible from a same docbook
> > xml to create man pages and a normal pdf document?  Or must I have
> > one special docbook for man pages and another one for the other
> > formats?  Ideally, I want to be able to generate a nice PDF manual
> > and a man page from the same source, without having to duplicate
> > text.
> 

If you'd like to see an example of a docbook man page:

http://cvs.gnome.org/bonsai/cvsblame.cgi?file=libxml2%2Fdoc/xmllint.xml&rev=&root=/cvs/gnome

You can then use it to build html and pdf as you would any other DocBook
source.

Cheers,
John

^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2003-11-17 18:29 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2003-11-17 17:06 Creating man pages from Docbook - docbook2man does not generate man pages Hans Deragon
2003-11-17 17:17 ` Tim Waugh
2003-11-17 17:31   ` Hans Deragon
2003-11-17 17:40     ` Tim Waugh
2003-11-17 18:29       ` John Fleck

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).