From 4442e8c6b560929eed1dd153284b5cfe7cae3b49 Mon Sep 17 00:00:00 2001
From: gferg <>
Date: Mon, 24 Jul 2000 17:19:01 +0000
Subject: [PATCH] updated
---
LDP/builder/dsssl/ldp.dsl | 1 +
LDP/howto/linuxdoc/big-howto-template-ld.sgml | 56 +++++++++++++++++--
2 files changed, 52 insertions(+), 5 deletions(-)
diff --git a/LDP/builder/dsssl/ldp.dsl b/LDP/builder/dsssl/ldp.dsl
index 554a65d7..07b83db5 100644
--- a/LDP/builder/dsssl/ldp.dsl
+++ b/LDP/builder/dsssl/ldp.dsl
@@ -85,6 +85,7 @@
#t)
(define (toc-depth nd)
+ ;; more depth, 2 levels, to toc, instead of flat hierarchy
2)
diff --git a/LDP/howto/linuxdoc/big-howto-template-ld.sgml b/LDP/howto/linuxdoc/big-howto-template-ld.sgml
index 51174275..73fd3645 100644
--- a/LDP/howto/linuxdoc/big-howto-template-ld.sgml
+++ b/LDP/howto/linuxdoc/big-howto-template-ld.sgml
@@ -13,6 +13,7 @@ Changelog:
280500: Released. Added examples for diagrams
050600: Clarified intent, added acknowledgements and note on conventions, moved samples to the end, added table sample, added small section on style
190600: Updated and corrected copyright section
+ 240700: Added Troubleshooting section, cleaned up Getting Help and Bits and Pieces, fixed typo
The line below ends the comments section.
-->
@@ -23,9 +24,10 @@ The line below ends the comments section.
HOWTO-template for big HOWTOs
Stein Gjoen,
-v0.04 , 19 June 2000
+v0.05, 24 July 2000
template
+
This is a fully working template for big HOWTOs. The source contains
fully described slots to make a convenient framework for you to fill in
for making your own HOWTO, suggesting some names, conventions and contents
@@ -43,7 +45,7 @@ for the chapters.
Introduction
-disk!introduction
+template!introductionMy comments to the reader is in this style (emphasized).
Example lines are in plain roman style.
Note that extra comments and advice is found in comments
@@ -218,7 +220,7 @@ significantly.Credits
It is always nice to acknowledge people who help you with inputs, it
-is also regarded by mane as important in the Linux world new economy
+is also regarded by many as important in the Linux world new economy
In this version I have the pleasure of acknowledging
@@ -397,6 +399,42 @@ For more serious use you would need to be a little more advanced.
This is the place to explain it all, if applicable.
+Troubleshooting
rather than just hda. Also
+do not use numbers behind hda, those indicate partitions.
+
+
+
+Formatting
+
+
+/dev/hda1 to the command line.
+
+
+
Further Information
(your index root)!information resources
@@ -589,6 +627,14 @@ Please let me know if you have any other leads that can be of interest.
Getting Help
(your index root)!assistance, obtaining
+Your reader might still end up in a situation where extra help is
+needed from someone else, perhaps on the net. In order to get fast and
+efficient help it is best first to get some details on your system.
+What details matter depends on type of problem. For disk problems you
+need to know the disk controllers etc, for networking problems you
+have to know what ethernet card is used and version of drivers etc.
+Here is the place to suggest what details to have ready when asking
+for help.
In the end you might find yourself unable to solve your problems and need
help from someone else. The most efficient way is either to ask someone
@@ -696,9 +742,9 @@ This is a balance and dependent on the number of physical drives you have.
Bits and Pieces