Re: New Admin Guide TOC

[Howard Chu <hyc@symas.com>]

Gavin Henry wrote:
> Dear all,
>
> Just working on a proposal for a new TOC, which is basically a re-arranged
> version of the existing one with new sections.
>
> If you have had an idea/wish for a section for the guide, please let me
> know and I'll add it to the proposal.
>
> Anyone have an docs lying around unfinished they want to let me know about?
>
> Also, could we allow the TOC to have 3 layers, instead of the current 2?

Just set DOC_TOC to 3 in admin.sdf.

> This would help find things quickly e.g.
>
> Replication
>   Replication Strategies
>       Syncrepl
>       Delta Syncrepl
>   Recommended Solutions
>
> Backends
>   back-monitor
>       Overview
>       Configuration
>   back-hdb
>
> etc.
>
> Lastly, is it easy to do an index linking back to over sections? Is that
> just like "back-monitor: {{SECT Backends}}"

The current version of sdf doesn't have automatic index building for 
anything besides Framemaker. You'd have to write a few new perl 
subroutines to get that working. If you want the index to cover anything 
more than the section headers (which are already accumulated in the 
table of contents) then you'd need to define a new {{INDEX}} specifier 
and use it liberally in the documents.
> Thanks.


--
  -- Howard Chu
  Chief Architect, Symas Corp.  http://www.symas.com
  Director, Highland Sun        http://highlandsun.com/hyc
  OpenLDAP Core Team            http://www.openldap.org/project/