From nobody@FreeBSD.org  Sun Mar  7 00:58:40 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 9CFA0106566C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  7 Mar 2010 00:58:40 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 8B9A38FC0C
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  7 Mar 2010 00:58:40 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o270wdYB006376
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 7 Mar 2010 00:58:39 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o270wd3h006375;
	Sun, 7 Mar 2010 00:58:39 GMT
	(envelope-from nobody)
Message-Id: <201003070058.o270wd3h006375@www.freebsd.org>
Date: Sun, 7 Mar 2010 00:58:39 GMT
From: Aiza <aiza21@comclark.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Expand handbook Table of contents
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         144515
>Category:       docs
>Synopsis:       [handbook] Expand handbook Table of contents
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Mar 07 01:00:03 UTC 2010
>Closed-Date:    Wed Jan 22 14:42:40 UTC 2014
>Last-Modified:  Wed Jan 22 14:42:40 UTC 2014
>Originator:     Aiza
>Release:        8.0 release
>Organization:
n/a
>Environment:
>Description:
The handbook TOC 'Table of Contents' is incomplete. It is missing sub-section topic listings. 

It very hard to find the subject one is looking for in the handbook. The TOC only gets me to the general area in the handbook and then I have to (next page) through it looking for what I hope is there.

The TOC really needs to be expanded to display each and every sub-section topic of all the major sections now in the TOC.

For example Installing from a "ms/dos partition" or "splash screen usage".

These are both subjects in the handbook but are not in the TOC.
What good is am TOC that does not index its content?

The purpose of the TOC is to list all subjects documented in the handbook so the reader can skim through the TOC and click on the exact subject they want to read. Can not do that with the current handbook TOC. 
>How-To-Repeat:

>Fix:
Rebuild the TOC by adding links to every sub-section topic in the handbook.

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: gabor 
State-Changed-When: Wed Jan 22 14:37:11 UTC 2014 
State-Changed-Why:  
Currently, the TOC has three levels: part, chapter and section.  I am afraid 
that expanding more levels would be to verbose and thus affect usability. 
It is possible to download full PDF or HTML where you can use the search 
functions. Alternatively, you can use the index, however it needs some 
impriovements. 


Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Wed Jan 22 14:37:11 UTC 2014 
Responsible-Changed-Why:  
Currently, the TOC has three levels: part, chapter and section.  I am afraid 
that expanding more levels would be to verbose and thus affect usability. 
It is possible to download full PDF or HTML where you can use the search 
functions. Alternatively, you can use the index, however it needs some 
impriovements. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=144515 
>Unformatted:
