Differences between revisions 4 and 5
Revision 4 as of 2007-12-31 10:07:52
Size: 5232
Editor: OsamuAoki
Comment:
Revision 5 as of 2007-12-31 10:10:04
Size: 5232
Editor: OsamuAoki
Comment:
Deletions are marked like this. Additions are marked like this.
Line 24: Line 24:
== Document policy == == Documentation policy ==
Line 43: Line 43:
=== The popcon ===

The [http://popcon.debian.org/ popcon] data was presented as the objective measure for each package. It was downloaded on @@@pop-date@@@ and contains the total submission of @@@pop-submissions@@@ reports over @@@pop-packages@@@ binary packages and @@@pop-architectures@@@ architectures.

(!) Please note that the @@@arch@@@ unstable archive contains only @@@all-packages@@@ packages currently. The popcon data contains reports from many old system installations etc.

The popcon number preceded with "V:" for "votes" is calculated by 100 * (the popcon submissions for the package executed recently on the PC)/(the total popcon submissions).

The popcon number preceded with "I:" for "installs" is calculated by 100 * (the popcon submissions for the package installed on the PC)/(the total popcon submissions).

=== The package size ===

The package size data was also presented as the objective measure for each package. It is based on the "Installed-Size:" reported by "{{{apt-cache show}}} " command (currently on @@@arch@@@ architecture for {{{unstable}}} release). The reported size is in KiB (unit for 1024 bytes).

== Document conventions ==
=== Cconventions ====
Line 76: Line 62:
=== The popcon ===

The [http://popcon.debian.org/ popcon] data was presented as the objective measure for each package. It was downloaded on @@@pop-date@@@ and contains the total submission of @@@pop-submissions@@@ reports over @@@pop-packages@@@ binary packages and @@@pop-architectures@@@ architectures.

(!) Please note that the @@@arch@@@ unstable archive contains only @@@all-packages@@@ packages currently. The popcon data contains reports from many old system installations etc.

The popcon number preceded with "V:" for "votes" is calculated by 100 * (the popcon submissions for the package executed recently on the PC)/(the total popcon submissions).

The popcon number preceded with "I:" for "installs" is calculated by 100 * (the popcon submissions for the package installed on the PC)/(the total popcon submissions).

=== The package size ===

The package size data was also presented as the objective measure for each package. It is based on the "Installed-Size:" reported by "{{{apt-cache show}}} " command (currently on @@@arch@@@ architecture for {{{unstable}}} release). The reported size is in KiB (unit for 1024 bytes).

Do not use Edit(GUI) button.

?TableOfContents(4)

Copyright 2007 Osamu Aoki GPL, (Please agree to GPL, GPL2, and any version of GPL which is compatible with DSFG if you update any part of wiki page)

Preface

This [http://people.debian.org/~osamu/pub/getwiki/html/index.en.html Debian Reference (v2)] (@@@build-date@@@) is intended to provide a broad overview of the Debian system administration as a post-installation user's guide.

The position statement

The Debian system itself is a moving target for me to document it. When wrining this, the unreleased unstable version was used as its base. So please keep in mind that the description in this document may be outdated by the time you read this.

Please treat this as the secondary reference information and do not blame me if your system breaks by following this document. You are advised to check pertinent documentation available in the /usr/share/doc/<package_name>/ directory for each package and pertinent [http://bugs.debian.org bug reports]. You may need to install the corresponding documentation package named with "-doc" suffix for detailed information.

Please file bug report on debian-reference2 package (once released) or write me (osamu at debian.org) if you find any issues. You may alternatively edit the source text available as [http://wiki.debian.org/DebianReference/ the Debian Reference wiki page] and tell me to update the document.

The target reader

The target reader is someone who is willing to learn shell scripts but who is not ready to read all the C sources to figure out how the GNU/Linux system works.

Documentation policy

I made a conscious decision not to explain everything in detail if it is documented in the Unix style manual page (aka. manpage), in the GNU style info page, in the HOWTOs from [http://tldp.org/ The Linux Documentation Project] (TLDP), [http://wikipedia.org/ the free encyclopedia Wikipedia] or elsewhere.

Guiding rules

Following guiding rules were followed while compiling this document:

  • Provide overview and skip corner cases (Big Picture)

  • Keep It Short and Simple. (KISS)

  • Focus on non-GUI tools and consoles. (Use shell)

  • Do not reinvent the wheels. (Use pointers to the existing references)

  • Be objective. (Use [http://popcon.debian.org/ popcon].)

=== Cconventions ====

This document refers some command names followed by the number in parenthes , such as bash(1). This means that you are encouraged to obtain information from the manpage by typing the following on the shell command prompt:

$ man 1 bash 

This document provides information through short bash(1) shell command examples. I will use the following simplified shell prompt for the sake of readability of the examples:

# <command_in_root_account>
$ <command_in_user_account>
  • description_of_action

These shell prompts correspond to PS1='\$' and PS2=' ' environment variables. The # prompt can be considered as a short form of $ sudo, if you have configured sudo(8) as above.

(!) See the meaning of the PS1 and PS2 environment variables in the manpage of bash command.

The popcon

The [http://popcon.debian.org/ popcon] data was presented as the objective measure for each package. It was downloaded on @@@pop-date@@@ and contains the total submission of @@@pop-submissions@@@ reports over @@@pop-packages@@@ binary packages and @@@pop-architectures@@@ architectures.

(!) Please note that the @@@arch@@@ unstable archive contains only @@@all-packages@@@ packages currently. The popcon data contains reports from many old system installations etc.

The popcon number preceded with "V:" for "votes" is calculated by 100 * (the popcon submissions for the package executed recently on the PC)/(the total popcon submissions).

The popcon number preceded with "I:" for "installs" is calculated by 100 * (the popcon submissions for the package installed on the PC)/(the total popcon submissions).

The package size

The package size data was also presented as the objective measure for each package. It is based on the "Installed-Size:" reported by "apt-cache show " command (currently on @@@arch@@@ architecture for unstable release). The reported size is in KiB (unit for 1024 bytes).

The Debian quotes

Here are some interesting quotes from the Debian mailing list which may help enlighten new users:

  • "This is Unix. It gives you enough rope to hang yourself." --- Miquel van Smoorenburg <miquels@cistron.nl>

  • "Unix IS user friendly... It's just selective about who its friends are." --- Tollef Fog Heen <tollef@add.no>

Warranties

This document does not replace any authoritative guides.

All warranties are disclaimed. All trademarks are property of their respective trademark owners.