Bug#542005: debiandoc2texinfo: should add @dircategory/@direntry

2009-09-12 Thread Osamu Aoki
Hi,

I must have overlooked (or spam filter ate) this bug report.

This is important bug to fix to get many documentation to comply with
the updated policy.

Of course, people can use sed script to insert any thing into generated
texinfo source.  Wait... I added -s option feature to debiandoc2texinfo
and debiandoc2info too.

  debiandoc2texinfo [-O] [-X custom_dir] [-s script] [shared options]
  debiandoc2info [-X custom_dir] [-s script] [-v] [shared options]

So you create sed script to insert such section is proper way.

I think all we have to do is show example script in updated manpage.

But how many source is affected by this policy issue.

Osamu



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org



Bug#542005: debiandoc2texinfo: should add @dircategory/@direntry

2009-08-17 Thread Bill Allombert
Package: debiandoc-sgml
Version: 1.2.9
Severity: normal

Hello DebianDoc-SGML maintainers

Policy 3.8.3, Section 12.2, now require info files to carry 
INFO-DIR-SECTION and START-INFO-DIR-ENTRY/END-INFO-DIR-ENTRY
statements. This is generally achieved by adding
@dircategory and @direntry/@end direntry to the texinfo file.
Please read policy for detail.

It would be very useful if debiandoc2texinfo would provide a 
way to generate such entries in the info file for compliance with
policy.

Cheers,
-- 
Bill. ballo...@debian.org

Imagine a large red swirl here. 



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org