← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to ca/administrivia/administrivia.xml

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

Lines of Context:
ca/administrivia/administrivia.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 29689 untranslated -->
 
3
 
 
4
<appendix id="administrivia">
 
5
 <title>Administrivia</title>
 
6
 
 
7
 
 
8
 <sect1 id="about">
 
9
 <title>About This Document</title>
 
10
 
 
11
<para>
 
12
 
 
13
This manual was created for Sarge's debian-installer, based on
 
14
the Woody installation manual for boot-floppies, which was based
 
15
on earlier Debian installation manuals, and on the Progeny
 
16
distribution manual which was released under GPL in 2003.
 
17
 
 
18
</para><para>
 
19
 
 
20
This document is written in DocBook XML.  Output formats are generated
 
21
by various programs using information from the
 
22
<classname>docbook-xml</classname> and
 
23
<classname>docbook-xsl</classname> packages.
 
24
 
 
25
</para><para>
 
26
 
 
27
In order to increase the maintainability of this document, we use
 
28
a number of XML features, such as entities and profiling attributes.
 
29
These play a role akin to variables and conditionals in programming
 
30
languages.  The XML source to this document contains information for
 
31
each different architecture &mdash; profiling attributes are used to
 
32
isolate certain bits of text as architecture-specific.
 
33
 
 
34
<!--
 
35
</para><para>
 
36
 
 
37
Translators can uncomment this paragraph and add an acknowledgement
 
38
to the people responsible for the translation of the manual.
 
39
Translation teams are advised to just mention the coordinator and maybe
 
40
major contributors and thank everybody else in a phrase like "all
 
41
translators and reviewers from the translation team for <your language>
 
42
at <your l10n mailinglist>".
 
43
 
 
44
(Note: support for this for translations using PO files will be added
 
45
 soon.)
 
46
-->
 
47
 
 
48
</para>
 
49
 </sect1>
 
50
 
 
51
 <sect1 id="contributing">
 
52
 <title>Contributing to This Document</title>
 
53
 
 
54
<para>
 
55
 
 
56
If you have problems or suggestions regarding this document, you
 
57
should probably submit them as a bug report against the package
 
58
<classname>debian-installer-manual</classname>.  See the
 
59
<classname>reportbug</classname> package or read the online
 
60
documentation of the <ulink url="&url-bts;">Debian Bug
 
61
Tracking System</ulink>.  It would be nice if you could check the
 
62
<ulink url="&url-bts;debian-installer-manual">open bugs against
 
63
debian-installer-manual</ulink> to see whether your problem has
 
64
already been reported. If so, you can supply additional corroboration
 
65
or helpful information to
 
66
<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
 
67
where <replaceable>XXXX</replaceable> is the number for the
 
68
already-reported bug.
 
69
 
 
70
</para><para>
 
71
 
 
72
Better yet, get a copy of the DocBook source for this document, and
 
73
produce patches against it.  The DocBook source can be found at the
 
74
<ulink url="&url-d-i-websvn;">debian-installer WebSVN</ulink>. If
 
75
you're not familiar with DocBook, don't worry:
 
76
there is a simple cheatsheet in the manuals directory that will get
 
77
you started. It's like html, but oriented towards the meaning of
 
78
the text rather than the presentation. Patches submitted to the
 
79
debian-boot mailing list (see below) are welcomed.
 
80
For instructions on how to check out the sources via SVN, see
 
81
<ulink url="&url-d-i-readme;">README</ulink>
 
82
from the source root directory.
 
83
 
 
84
</para><para>
 
85
 
 
86
Please do <emphasis>not</emphasis> contact the authors of this
 
87
document directly.  There is also a discussion list for &d-i;, which
 
88
includes discussions of this manual.  The mailing list is
 
89
<email>debian-boot@lists.debian.org</email>.  Instructions for
 
90
subscribing to this list can be found at the <ulink
 
91
url="&url-debian-lists-subscribe;">Debian Mailing
 
92
List Subscription</ulink> page; or you can browse the <ulink
 
93
url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
 
94
online.
 
95
 
 
96
</para>
 
97
 
 
98
 </sect1>
 
99
 
 
100
 <sect1 id="contributors">
 
101
 <title>Major Contributions</title>
 
102
 
 
103
<para>
 
104
 
 
105
This document was originally written by Bruce Perens, Sven Rudolph, Igor
 
106
Grobman, James Treacy, and Adam Di Carlo. Sebastian Ley wrote the
 
107
Installation Howto.
 
108
Many, many Debian users and developers contributed to this document.
 
109
Particular note must be made of Michael Schmitz (m68k support), Frank
 
110
Neumann (original author of the <ulink
 
111
url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
 
112
Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
 
113
Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.
 
114
We have to thank Pascal Le Bail for useful information about booting
 
115
from USB memory sticks. Miroslav Kuře has documented a lot of the new
 
116
functionality in Sarge's debian-installer.
 
117
 
 
118
</para><para>
 
119
 
 
120
Extremely helpful text and information was found in Jim Mintha's HOWTO
 
121
for network booting (no URL available), the <ulink
 
122
url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
 
123
url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
 
124
url="&url-sparc-linux-faq;">Linux for SPARC Processors
 
125
FAQ</ulink>, the <ulink
 
126
url="&url-alpha-faq;">Linux/Alpha
 
127
FAQ</ulink>, amongst others.  The maintainers of these freely
 
128
available and rich sources of information must be recognized.
 
129
 
 
130
</para><para>
 
131
 
 
132
The section on chrooted installations in this manual
 
133
(<xref linkend="linux-upgrade"/>) was derived in part from
 
134
documents copyright Karsten M. Self.
 
135
 
 
136
</para><para arch="i386">
 
137
 
 
138
The section on installations over plip in this manual
 
139
(<xref linkend="plip"/>) was based on the
 
140
<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink>
 
141
by Gilles Lamiral.
 
142
 
 
143
</para>
 
144
 </sect1>
 
145
 
 
146
 <sect1 id="trademarks">
 
147
 <title>Trademark Acknowledgement</title>
 
148
<para>
 
149
 
 
150
All trademarks are property of their respective trademark owners.
 
151
 
 
152
</para>
 
153
 </sect1>
 
154
</appendix>
 
155