OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: Re: DOCBOOK: DocBook markup and possibly a RFE.


Nik Clayton <nik@nothing-going-on.demon.co.uk> writes:

> On Mon, May 22, 2000 at 02:47:18PM -0300, Jorge Godoy wrote:
> > Although this works, I don't think this is the optimal
> > solution... Having to have all man pages in a file defined as entities
> > isn't the best solution... 
> 
> You don't have to do that.  You can just use <citerefentry>...</> as I 
> showed in the example.  
> 
> In case you didn't realise, <citerefentry> and the others are standard
> DocBook.
> 
> The only thing that creating the entities does is cut down on the amount
> of typing required.
> 
> Or am I misunderstanding you?

Yes and no. :-)

I understood what's happening with the entities. And I understood why
you've used them. 

What I was talking about is the amount of entities that we'll need to
create to easy things for authors. There are thousands of man pages. 

There should be an easy way to achieve the same thing... As an
example:

<man section="1">mail</man>

(which could be <citerefentry section="1">mail</citerefentry> as well) 

This is a very common thing on Unix. It's so common that it could have
it's own tag or some customization to make things look like they're
usually shown to users.

The above example would output mail(1) and would eliminate all this
code and the need for the entities as well. 

-- 
Godoy.	<godoy@conectiva.com> 

Departamento de Publicações
Publishing Department                   Conectiva S.A.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC