en/administrivia/administrivia.xml

<!-- retain these comments for translator revision tracking -->
<!-- $Id$ -->

<appendix id="administrivia">
 <title>Administrivia</title>


 <sect1 id="about">
 <title>About This Document</title>

<para>

This manual was created for Sarge's debian-installer, based on
the Woody installation manual for boot-floppies, which was based
on earlier Debian installation manuals, and on the Progeny
distribution manual which was released under GPL in 2003.

</para><para>

This document is written in DocBook XML.  Output formats are generated
by various programs using information from the
<classname>docbook-xml</classname> and
<classname>docbook-xsl</classname> packages.

</para><para>

In order to increase the maintainability of this document, we use
a number of XML features, such as entities and profiling attributes.
These play a role akin to variables and conditionals in programming
languages.  The XML source to this document contains information for
each different architecture &mdash; profiling attributes are used to
isolate certain bits of text as architecture-specific.

</para><para condition="about-langteam">

Translators can use this paragraph to acknowledge the people responsible
for the translation of the manual.
Translation teams are advised to just mention the coordinator and maybe
major contributors and thank everybody else in a phrase like "all
translators and reviewers from the translation team for {your language}
at {your l10n mailinglist}".

See build/lang-options/README on how to enable this paragraph.
Its condition is "about-langteam".

</para>
 </sect1>

 <sect1 id="contributing">
 <title>Contributing to This Document</title>

<para>

If you have problems or suggestions regarding this document, you
should probably submit them as a bug report against the package
<classname>installation-guide</classname>.  See the
<classname>reportbug</classname> package or read the online
documentation of the <ulink url="&url-bts;">Debian Bug
Tracking System</ulink>.  It would be nice if you could check the
<ulink url="&url-bts;installation-guide">open bugs against
installation-guide</ulink> to see whether your problem has
already been reported. If so, you can supply additional corroboration
or helpful information to
<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
where <replaceable>XXXX</replaceable> is the number for the
already-reported bug.

</para><para>

Better yet, get a copy of the DocBook source for this document, and
produce patches against it.  The DocBook source can be found at the
<ulink url="&url-d-i-websvn;">debian-installer WebSVN</ulink>. If
you're not familiar with DocBook, don't worry:
there is a simple cheatsheet in the manuals directory that will get
you started. It's like html, but oriented towards the meaning of
the text rather than the presentation. Patches submitted to the
debian-boot mailing list (see below) are welcomed.
For instructions on how to check out the sources via SVN, see
<ulink url="&url-d-i-readme;">README</ulink>
from the source root directory.

</para><para>

Please do <emphasis>not</emphasis> contact the authors of this
document directly.  There is also a discussion list for &d-i;, which
includes discussions of this manual.  The mailing list is
<email>debian-boot@lists.debian.org</email>.  Instructions for
subscribing to this list can be found at the <ulink
url="&url-debian-lists-subscribe;">Debian Mailing
List Subscription</ulink> page; or you can browse the <ulink
url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
online.

</para>

 </sect1>

 <sect1 id="contributors">
 <title>Major Contributions</title>

<para>

This document was originally written by Bruce Perens, Sven Rudolph, Igor
Grobman, James Treacy, and Adam Di Carlo. Sebastian Ley wrote the
Installation Howto.

</para><para>

Miroslav Kuře has documented a lot of the new functionality in Sarge's
debian-installer. Frans Pop was the main editor and release manager during
the Etch, Lenny and Squeeze releases.

</para><para>

Many, many Debian users and developers contributed to this document.
Particular note must be made of Michael Schmitz (m68k support), Frank
Neumann (original author of the <ulink
url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.
We have to thank Pascal Le Bail for useful information about booting
from USB memory sticks.

</para><para>

Extremely helpful text and information was found in Jim Mintha's HOWTO
for network booting (no URL available), the <ulink
url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
url="&url-sparc-linux-faq;">Linux for SPARC Processors
FAQ</ulink>, the <ulink
url="&url-alpha-faq;">Linux/Alpha
FAQ</ulink>, amongst others.  The maintainers of these freely
available and rich sources of information must be recognized.

</para><para>

The section on chrooted installations in this manual
(<xref linkend="linux-upgrade"/>) was derived in part from
documents copyright Karsten M. Self.

</para><para arch="x86">

The section on installations over plip in this manual
(<xref linkend="plip"/>) was based on the
<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink>
by Gilles Lamiral.

</para>
 </sect1>

 <sect1 id="trademarks">
 <title>Trademark Acknowledgement</title>
<para>

All trademarks are property of their respective trademark owners.

</para>
 </sect1>
</appendix>

1	<!-- retain these comments for translator revision tracking -->
2	<!-- $Id$ -->
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 — profiling attributes are used to
32	isolate certain bits of text as architecture-specific.
33
34	</para><para condition="about-langteam">
35
36	Translators can use this paragraph to acknowledge the people responsible
37	for the translation of the manual.
38	Translation teams are advised to just mention the coordinator and maybe
39	major contributors and thank everybody else in a phrase like "all
40	translators and reviewers from the translation team for {your language}
41	at {your l10n mailinglist}".
42
43	See build/lang-options/README on how to enable this paragraph.
44	Its condition is "about-langteam".
45
46	</para>
47	</sect1>
48
49	<sect1 id="contributing">
50	<title>Contributing to This Document</title>
51
52	<para>
53
54	If you have problems or suggestions regarding this document, you
55	should probably submit them as a bug report against the package
56	<classname>installation-guide</classname>. See the
57	<classname>reportbug</classname> package or read the online
58	documentation of the <ulink url="&url-bts;">Debian Bug
59	Tracking System</ulink>. It would be nice if you could check the
60	<ulink url="&url-bts;installation-guide">open bugs against
61	installation-guide</ulink> to see whether your problem has
62	already been reported. If so, you can supply additional corroboration
63	or helpful information to
64	<email><replaceable>XXXX</replaceable>@bugs.debian.org</email>,
65	where <replaceable>XXXX</replaceable> is the number for the
66	already-reported bug.
67
68	</para><para>
69
70	Better yet, get a copy of the DocBook source for this document, and
71	produce patches against it. The DocBook source can be found at the
72	<ulink url="&url-d-i-websvn;">debian-installer WebSVN</ulink>. If
73	you're not familiar with DocBook, don't worry:
74	there is a simple cheatsheet in the manuals directory that will get
75	you started. It's like html, but oriented towards the meaning of
76	the text rather than the presentation. Patches submitted to the
77	debian-boot mailing list (see below) are welcomed.
78	For instructions on how to check out the sources via SVN, see
79	<ulink url="&url-d-i-readme;">README</ulink>
80	from the source root directory.
81
82	</para><para>
83
84	Please do <emphasis>not</emphasis> contact the authors of this
85	document directly. There is also a discussion list for &d-i;, which
86	includes discussions of this manual. The mailing list is
87	<email>debian-boot@lists.debian.org</email>. Instructions for
88	subscribing to this list can be found at the <ulink
89	url="&url-debian-lists-subscribe;">Debian Mailing
90	List Subscription</ulink> page; or you can browse the <ulink
91	url="&url-debian-list-archives;">Debian Mailing List Archives</ulink>
92	online.
93
94	</para>
95
96	</sect1>
97
98	<sect1 id="contributors">
99	<title>Major Contributions</title>
100
101	<para>
102
103	This document was originally written by Bruce Perens, Sven Rudolph, Igor
104	Grobman, James Treacy, and Adam Di Carlo. Sebastian Ley wrote the
105	Installation Howto.
106
107	</para><para>
108
109	Miroslav Kuře has documented a lot of the new functionality in Sarge's
110	debian-installer. Frans Pop was the main editor and release manager during
111	the Etch, Lenny and Squeeze releases.
112
113	</para><para>
114
115	Many, many Debian users and developers contributed to this document.
116	Particular note must be made of Michael Schmitz (m68k support), Frank
117	Neumann (original author of the <ulink
118	url="&url-m68k-old-amiga-install;">Amiga install manual</ulink>),
119	Arto Astala, Eric Delaunay/Ben Collins (SPARC information), Tapio
120	Lehtonen, and Stéphane Bortzmeyer for numerous edits and text.
121	We have to thank Pascal Le Bail for useful information about booting
122	from USB memory sticks.
123
124	</para><para>
125
126	Extremely helpful text and information was found in Jim Mintha's HOWTO
127	for network booting (no URL available), the <ulink
128	url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
129	url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
130	url="&url-sparc-linux-faq;">Linux for SPARC Processors
131	FAQ</ulink>, the <ulink
132	url="&url-alpha-faq;">Linux/Alpha
133	FAQ</ulink>, amongst others. The maintainers of these freely
134	available and rich sources of information must be recognized.
135
136	</para><para>
137
138	The section on chrooted installations in this manual
139	(<xref linkend="linux-upgrade"/>) was derived in part from
140	documents copyright Karsten M. Self.
141
142	</para><para arch="x86">
143
144	The section on installations over plip in this manual
145	(<xref linkend="plip"/>) was based on the
146	<ulink url="&url-plip-install-howto;">PLIP-Install-HOWTO</ulink>
147	by Gilles Lamiral.
148
149	</para>
150	</sect1>
151
152	<sect1 id="trademarks">
153	<title>Trademark Acknowledgement</title>
154	<para>
155
156	All trademarks are property of their respective trademark owners.
157
158	</para>
159	</sect1>
160	</appendix>
161