LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

Ready for release.

This commit is contained in:
fevrier 2005-08-11 22:41:03 +00:00
parent 4f5b7e7ad0
commit b3ea2b05b8
1 changed files with 38 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

73
LDP/howto/docbook/Online-Troubleshooting-HOWTO.sgml
View File

@ -33,7 +33,8 @@
<authorinitials>JPG</authorinitials>
<revremark>
Added FOLDOC (thanks to Howard Mann for suggesting this).
General document update and cleanup.
General document update and cleanup. Added the text of the Open
Publication Licence at the end of the document.
</revremark>
</revision>
@ -100,13 +101,8 @@
Troubleshooting a Linux-related issue is often perceived as a difficult
task. But, often, the solution is just a few clicks away on the
internet.
</para>
<para>
This document will direct Linux users to resources available on the
Internet that provide access to a vast amount of Linux-related
internet. This document will direct Linux users to resources available
on the Internet that provide access to a vast amount of Linux-related
information useful in the troubleshooting problems.
</para></abstract>
@ -143,7 +139,7 @@ publication of user's manuals, lists of Frequently-Asked-Questions
document (HOWTO's) and tutorials. In addition, users often assist others
through the forum of Usenet and other newsgroups and the posted messages
are readily accessible in the form of searchable archives. These
linux-related newsgroups are renowned for their high level of user
Linux-related newsgroups are renowned for their high level of user
participation. In significant measure, Linux may be considered a product
of the Internet.
@ -173,16 +169,18 @@ this quest.
</para>
<section id="docupdates">
<title>Document Updates</title>
<para>
<section id="updates">
<title>Document Updates</title>
<para>
The <ulink url="&tldpurl;">latest version</ulink> of this document
will always be available at the <ulink url="http://www.tldp.org">Linux
Documentation Project</ulink>. The document will also be available in
SGML, PS, PDF, and other formats at that website.
The <ulink url="&tldpurl;">latest version</ulink> of this document will
always be available at the <ulink url="http://www.tldp.org">Linux
Documentation Project</ulink>. The document will also be available in
SGML, PS, PDF, and other formats at that website.
</para>
</para>
</section>
@ -201,7 +199,13 @@ Open Publication Licence, v1.0 or later (see <xref linkend="openpub"/>).
</section>
<section>
<title>Feedback and Corrections</title>
<title>
Feedback and Corrections
</title>
<para>
I always welcome feedback and constructive criticism. You can reach me
@ -217,7 +221,13 @@ suggestion thoughtful consideration. In anticipation, Thanks.
</section>
<section>
<title>Document history</title>
<title>
Document history
</title>
<para>
Howard Mann conceived and formulated the first version of this HOWTO. He
@ -429,9 +439,9 @@ page</ulink>. In particular, the engine often returns the most useful
pages first; in fact, I have often found that the first listed page
contains the information I need. Because it caches web pages, it is
relatively fast at displaying requested items. It has a so-called
<emphasis>GoogleScout (TM)</emphasis> feature, activated by clicking on
the "similar pages" links, that provides additional relevant links with
each item returned.
<trademark>GoogleScout</trademark> feature, activated by clicking on the
"similar pages" links, that provides additional relevant links with each
item returned.
</para>
@ -446,7 +456,7 @@ each item returned.
<para>
The ability to search for and retrieve information from archived posts
to the linux-related (Usenet) newsgroups represents a powerful means of
to the Linux-related (Usenet) newsgroups represents a powerful means of
troubleshooting in Linux.
</para>
@ -455,7 +465,7 @@ troubleshooting in Linux.
Search engines permit one to search the archives by stipulating the
forum, keywords, authors, dates, language and combinations thereof.
Because the number of linux-related newsgroups is large, the likelihood
Because the number of Linux-related newsgroups is large, the likelihood
of finding useful information is high.
</para>
@ -508,7 +518,7 @@ latter and was on my way. This entire process took about 10 minutes!
<para>
As you might expect, there are a very large number of linux-related
As you might expect, there are a very large number of Linux-related
Mailing Lists that enable developers and users to communicate and
collaborate on projects. These Lists cover every conceivable aspect of
Linux, from the technical arcana of kernel development to the relatively
@ -661,14 +671,6 @@ engine</link>, using the "howto" keyword.
</para>
<note><para>
It is often a good idea to check how old are the documents you find.
Outdated documents will probably not be very helpful. Look at the date
of the document, as well as the software versions it mentions.
</para></note>
</section>
<section id="usersmanuals">
@ -681,7 +683,8 @@ Some of the major Linux distributions, Window Managers and Desktop
Environments publish their user's manual online. If the entire manual is
not online, installation and configuration guides are typically found at
the relevant website. This also applies to major applications like the
<emphasis>Gimp</emphasis> (GNU Image Manipulation Program) or Apache.
<emphasis>Gimp</emphasis> (GNU Image Manipulation Program) or
<emphasis>Apache</emphasis>.
</para>
@ -1114,7 +1117,7 @@ document.
<listitem><para>
All substantive modifications (including deletions) be either clearly
marked up in the document or else described in an attacHMent to the
marked up in the document or else described in an attachment to the
document.
</para></listitem>