/usr/share/debian-reference/apa.en.html is in debian-reference-en 2.72.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Appendix A. Appendix</title>
<link rel="stylesheet" type="text/css" href="debian-reference.css"/>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<link rel="home" href="index.en.html" title="Debian Reference"/>
<link rel="up" href="index.en.html" title="Debian Reference"/>
<link rel="prev" href="ch12.en.html" title="Chapter 12. Programming"/>
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Appendix A. Appendix</th>
</tr>
<tr>
<td align="left"><a accesskey="p" href="ch12.en.html"><img src="images/prev.png" alt="Prev"/></a> </td>
<th width="60%" align="center"> </th>
<td align="right"> </td>
</tr>
</table>
<hr/>
</div>
<div class="appendix">
<div class="titlepage">
<div>
<div>
<h1 class="title"><a id="_appendix"/>Appendix A. Appendix</h1>
</div>
</div>
</div>
<div class="toc">
<p>
<strong>Table of Contents</strong>
</p>
<dl class="toc">
<dt>
<span class="section">
<a href="apa.en.html#_the_debian_maze">A.1. The Debian maze</a>
</span>
</dt>
<dt>
<span class="section">
<a href="apa.en.html#_copyright_history">A.2. Copyright history</a>
</span>
</dt>
<dt>
<span class="section">
<a href="apa.en.html#_document_format">A.3. Document format</a>
</span>
</dt>
</dl>
</div>
<p>Here are backgrounds of this document.</p>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="_the_debian_maze"/>A.1. The Debian maze</h2>
</div>
</div>
</div>
<p>The Linux system is a very powerful computing platform for a networked computer. However, learning how to use all its capabilities is not easy. Setting up the LPR printer queue with a non-PostScript printer was a good example of stumble points. (There are no issues anymore since newer installations use the new CUPS system.)</p>
<p>There is a complete, detailed map called the "SOURCE CODE". This is very accurate but very hard to understand. There are also references called HOWTO and mini-HOWTO. They are easier to understand but tend to give too much
detail and lose the big picture. I sometimes have a problem finding the right section in a long HOWTO when I need a few commands to invoke.</p>
<p>I hope this "Debian Reference (version 2.72)" (2018-04-15 23:53:16 UTC) provides a good starting direction for people in the Debian maze.</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="_copyright_history"/>A.2. Copyright history</h2>
</div>
</div>
</div>
<p>The Debian Reference was initiated by me, Osamu Aoki <osamu at debian dot org>, as a personal system administration memo. Many contents came from the knowledge I gained from <a class="ulink" href="http://lists.debian.org/debian-user/">the debian-user mailing list</a> and other Debian resources.</p>
<p>Following a suggestion from Josip Rodin, who was very active with the <a class="ulink" href="https://www.debian.org/doc/ddp">Debian Documentation Project (DDP)</a>, "Debian Reference (version 1, 2001-2007)" was created as a part of DDP documents.</p>
<p>After 6 years, I realized that the original "Debian Reference (version 1)" was outdated and started to rewrite many contents. New "Debian Reference (version 2)" is released in 2008.</p>
<p>The tutorial contents can trace its origin and its inspiration in followings.</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
"<a class="ulink" href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/user-beta-1.pdf.gz">Linux User's Guide</a>" by Larry Greenfield (December 1996)
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
obsoleted by "Debian Tutorial"
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
"<a class="ulink" href="https://www.debian.org/doc/manuals/debian-tutorial/">Debian Tutorial</a>" by Havoc Pennington. (11 December, 1998)
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
partially written by Oliver Elphick, Ole Tetlie, James Treacy, Craig Sawyer, and Ivan E. Moore II
</p>
</li>
<li class="listitem">
<p>
obsoleted by "Debian GNU/Linux: Guide to Installation and Usage"
</p>
</li>
</ul>
</div>
</li>
<li class="listitem">
<p>
"<a class="ulink" href="http://archive.debian.net/woody/debian-guide">Debian GNU/Linux: Guide to Installation and Usage</a>" by John Goerzen and Ossama Othman (1999)
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
obsoleted by "Debian Reference (version 1)"
</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
<p>The package and archive description can trace some of their origin and their inspiration in following.</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
"<a class="ulink" href="https://www.debian.org/doc/manuals/debian-faq/">Debian FAQ</a>" (March 2002 version, when this was maintained by Josip Rodin)
</p>
</li>
</ul>
</div>
<p>The other contents can trace some of their origin and their inspiration in following.</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
"<a class="ulink" href="http://packages.debian.org/search?keywords=debian-reference&searchon=sourcenames&exact=1&suite=all&section=all">Debian Reference</a> (version 1)" by Osamu Aoki (2001–2007)
</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
obsoleted by the newer "Debian Reference (version 2)" in 2008.
</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
<p>The previous "Debian Reference (version 1)" was created with many contributors.</p>
<div class="itemizedlist">
<ul class="itemizedlist">
<li class="listitem">
<p>
the major contents contribution on network configuration topics by Thomas Hood
</p>
</li>
<li class="listitem">
<p>
significant contents contribution on X and VCS related topics by Brian Nelson
</p>
</li>
<li class="listitem">
<p>
the help on the build scripts and many content corrections by Jens Seidel
</p>
</li>
<li class="listitem">
<p>
extensive proofreading by David Sewell
</p>
</li>
<li class="listitem">
<p>
many contributions by the translators, contributors, and bug reporters
</p>
</li>
</ul>
</div>
<p>Many manual pages and info pages on the Debian system were used as the primary references to write this document. To the extent Osamu Aoki considered within the <a class="ulink" href="http://en.wikipedia.org/wiki/Fair_use">fair use</a>, many parts of them, especially command definitions, were used as phrase pieces after careful editorial efforts to fit them into the style and the objective of this document.</p>
<p>The gdb debugger description was expanded using <a class="ulink" href="http://wiki.debian.org/HowToGetABacktrace">Debian wiki contents on backtrace</a> with consent by Ari Pollak, Loïc Minier, and Dafydd Harries.</p>
<p>Contents of the current "Debian Reference (version 2.72)" (2018-04-15 23:53:16 UTC) are mostly my own work except as mentioned above. These has been updated by the contributors too.</p>
<p>The author, Osamu Aoki, thanks all those who helped make this document possible.</p>
</div>
<div class="section">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="_document_format"/>A.3. Document format</h2>
</div>
</div>
</div>
<p>The source of the English original document is currently written in <a class="ulink" href="http://packages.debian.org/search?keywords=asciidoc">AsciiDoc</a> text files. <a class="ulink" href="http://packages.debian.org/search?keywords=asciidoc">AsciiDoc</a> is used as convenience only since it is less typing than straight XML and supports table in the very intuitive format. You should think XML and PO files as real source files. Via build script, it is converted to DocBook XML format and automatically generated data are inserted to form a final Docbook XML source. This final Docbook XML source can be converted to HTML, epub, plain text, PostScript, and PDF. (Some formats may be skipped for distribution.)</p>
</div>
</div>
<div class="navfooter">
<hr/>
<table width="100%" summary="Navigation footer">
<tr>
<td align="left"><a accesskey="p" href="ch12.en.html"><img src="images/prev.png" alt="Prev"/></a> </td>
<td align="center"> </td>
<td align="right"> </td>
</tr>
<tr>
<td align="left" valign="top">Chapter 12. Programming </td>
<td align="center">
<a accesskey="h" href="index.en.html">
<img src="images/home.png" alt="Home"/>
</a>
</td>
<td align="right" valign="top"> </td>
</tr>
</table>
</div>
</body>
</html>
|