[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#538665: debian-policy: "Info documents" section is outdated



On Fri, Aug 14, 2009 at 09:52:59AM -0700, Russ Allbery wrote:
> Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr> writes:
> 
> >> Reading the comment I will assume that debiandoc2info is the only package
> >> that need to be fixed and waive this part. I will also try to get
> >> debiandoc2info fixed.
> 
> > Hmm. debiandoc2info is just generating a texinfo file and call makeinfo
> > on it. makeinfo does not generate
> > START-INFO-DIR-ENTRY/END-INFO-DIR-ENTRY by itself. How are we supposed
> > to proceeed ?
> 
> The generated file should contain a section like:
> 
> @dircategory Individual utilities
> @direntry
> * example: (example).               An example info directory entry.
> @end direntry
> 
> which will cause makeinfo to generate the directory entry information.

Probably this information should be included as a footnote in policy.  At this
stage, it is still unclear to me what is the expected/correct process to get
the START-INFO-DIR-ENTRY/END-INFO-DIR-ENTRY included in an info file.
The data that used to be passed to install-menu now need to be provided 
higher in the chain.

Cheers,
-- 
Bill. <ballombe@debian.org>

Imagine a large red swirl here. 



Reply to: