Re: debian-refcard
Hi,
"W. Martin Borgert" <debacle@debian.org> wrote:
> Quoting Holger Wansing <linux@wansing-online.de>:
> > In Jessie, apt-get and apt-cache are valid commands, as well as the
> > '/etc/init.d/file restart' constructs.
> > Are there changings ongoing, making that all invalid?
> > If yes, what are the new variants of that commands?
>
> The new apt commands are (IMHO) nicer, esp. for new users,
> not only because of the colourful output:
>
> apt-get update -> apt update
> apt-get upgrade -> apt upgrade
> apt-get dist-upgrade -> apt full-upgrade
> apt-cache show pkg -> apt show pkg
> apt-cache search str -> apt search str
> apt-cache policy pkg -> apt list -a pkg
> apt-get remove pkg -> apt remove pkg
>
> Some of the new systemd commands are (IMHO) more powerful and they
> do not differ between distributions:
>
> /etc/init.d/service start -> systemctl start "service".service
> /etc/init.d/service status -> systemctl status "service".service
> /etc/init.d/service stop -> systemctl stop "service".service
> /etc/init.d/service restart -> systemctl restart "service".service
> halt -> systemctl halt
> reboot -> systemctl reboot
> poweroff -> systemctl poweroff
> hibernate -> systemctl hibernate
> suspend -> systemctl suspend
>
> A lot of this stuff is still missing in the refcard - yet another
> reason to drop the Apache section. I wonder, whether make-kpkg or
> m-a still deserve a place in the refcard?
Sounds sensible to me.
So I have prepared a diff (attached) which addresses:
- change the versioning scheme
- update content (command strings for apt, sysvinit/systemd, console config)
- drop content (Apache, Samba, make-kpkg, m-a)
As a second step, I could unfuzzy most translations, since the command
strings ("apt-get install", "/etc/init.d/service start" etc.) are not translated
in all translated languages, so no work from translators would be strictly
required. That would mean, that translation statistic would be not so bad after
this...
Please comment! Especially on the changing of the versioning, since
I am not a developer.
Holger
--
============================================================
Created with Sylpheed 3.5.0 under
D E B I A N L I N U X 8 . 0 " J E S S I E " .
Registered Linux User #311290 - https://linuxcounter.net/
============================================================
Index: debian/changelog
===================================================================
--- debian/changelog (Revision 11072)
+++ debian/changelog (Arbeitskopie)
@@ -1,4 +1,4 @@
-refcard (5.0.10) UNRELEASED; urgency=low
+refcard (9.0) UNRELEASED; urgency=low
[ David Prévot ]
* Get rid of now useless texlive-lang-greek build-dependency
@@ -11,6 +11,12 @@
- German: Holger Wansing.
- Japanese: Victory.
+ * Change versioning scheme to make major version-number match the
+ major number of the relevant Debian release.
+
+ * Update content (apt, sysvinit/systemd, console config) to follow
+ development in Stretch; drop Samba/Apache/m-a/make-kpkg content.
+
[ Beatrice Torracca ]
* Update Italian translation
Index: entries.dbk
===================================================================
--- entries.dbk (Revision 11072)
+++ entries.dbk (Arbeitskopie)
@@ -156,7 +156,7 @@
<glossentry id="dpkg-reconfigure">
<glossterm>dpkg-reconfigure
<replaceable>package-name</replaceable></glossterm>
- <glossdef><para>Reconfigure a package, e.g. console-common
+ <glossdef><para>Reconfigure a package, e.g. keyboard-configuration
(keyboard), locales (localisation).</para></glossdef>
</glossentry>
<glossentry id="update-alternatives">
@@ -169,23 +169,6 @@
<glossdef><para>After changing
<filename>/etc/default/grub</filename>.</para></glossdef>
</glossentry>
- <glossentry id="make-kpkg">
- <glossterm>make-kpkg <literal>--</literal>initrd
- <literal>--</literal>revision=2:my.1.0
- <literal>--</literal>rootcmd fakeroot <literal>--</literal>uc
- <literal>--</literal>us
- <literal>kernel_image</literal></glossterm>
- <glossdef><para>Build a kernel packages from sources, if a
- customised kernel is really needed, needs
- <literal>kernel-package</literal>.</para></glossdef>
- </glossentry>
- <glossentry id="m-a">
- <glossterm>m-a a-i module
- <literal>kernel_image</literal></glossterm>
- <glossdef><para>Create and install third-party modules
- (gspca, ...), needs
- <literal>module-assistant</literal>.</para></glossdef>
- </glossentry>
</glosslist>
</section>
<section id="daemons">
@@ -192,28 +175,43 @@
<title>Daemons and System</title>
<glosslist>
<glossentry id="restart">
- <glossterm><filename>/etc/init.d/<replaceable>file</replaceable></filename>
- restart</glossterm>
+ <glossterm><filename>systemctl restart
+ <replaceable>service</replaceable>.service</filename></glossterm>
<glossdef><para>Restart a service, system
daemon.</para></glossdef>
</glossentry>
<glossentry id="stop">
- <glossterm><filename>/etc/init.d/<replaceable>file</replaceable></filename>
- stop</glossterm>
+ <glossterm><filename>systemctl stop
+ <replaceable>service</replaceable>.service</filename></glossterm>
<glossdef><para>Stop a service, system
daemon.</para></glossdef>
</glossentry>
<glossentry id="start">
- <glossterm><filename>/etc/init.d/<replaceable>file</replaceable></filename>
- start</glossterm>
+ <glossterm><filename>systemctl start
+ <replaceable>service</replaceable>.service</filename></glossterm>
<glossdef><para>Start a service, system
daemon.</para></glossdef>
</glossentry>
<glossentry id="halt">
- <glossterm>halt, reboot, poweroff</glossterm>
- <glossdef><para>Halts, reboots, shuts down
- system.</para></glossdef>
+ <glossterm>systemctl halt</glossterm>
+ <glossdef><para>Halts system.</para></glossdef>
</glossentry>
+ <glossentry id="reboot">
+ <glossterm>systemctl reboot</glossterm>
+ <glossdef><para>Reboots system.</para></glossdef>
+ </glossentry>
+ <glossentry id="poweroff">
+ <glossterm>systemctl poweroff</glossterm>
+ <glossdef><para>Shuts down system.</para></glossdef>
+ </glossentry>
+ <glossentry id="suspend">
+ <glossterm>systemctl suspend</glossterm>
+ <glossdef><para>Suspends system.</para></glossdef>
+ </glossentry>
+ <glossentry id="hibernate">
+ <glossterm>systemctl hibernate</glossterm>
+ <glossdef><para>Hibernates system.</para></glossdef>
+ </glossentry>
<glossentry id="var-log">
<glossterm><filename>/var/log/</filename></glossterm>
<glossdef><para>All log files are under this
@@ -366,8 +364,8 @@
<section id="apt">
<title>APT</title>
<glosslist>
- <glossentry id="apt-get-update">
- <glossterm>apt-get update</glossterm>
+ <glossentry id="apt-update">
+ <glossterm>apt update</glossterm>
<glossdef><para>Update packages listings from package
repositories as listed in
<filename>/etc/apt/sources.list</filename>. Required whenever
@@ -374,65 +372,65 @@
that file or the contents of the repositories
change.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-search">
- <glossterm>apt-cache search
+ <glossentry id="apt-search">
+ <glossterm>apt search
<replaceable>search-string</replaceable></glossterm>
<glossdef><para>Search packages and descriptions for
<replaceable>search-string</replaceable>.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-policy">
- <glossterm>apt-cache policy
+ <glossentry id="apt-list">
+ <glossterm>apt list -a
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>Show versions and priorities of available
packages.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-show">
- <glossterm>apt-cache show
+ <glossentry id="apt-show">
+ <glossterm>apt show
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>Show package information
incl. description.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-showpkg">
- <glossterm>apt-cache showpkg
+ <glossentry id="apt-showpkg">
+ <glossterm>apt showpkg
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>Show package dependencies (needed
packages).</para></glossdef>
</glossentry>
- <glossentry id="apt-get-install">
- <glossterm>apt-get install
+ <glossentry id="apt-install">
+ <glossterm>apt install
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>Install packages from repositories with all
dependencies.</para></glossdef>
</glossentry>
- <glossentry id="apt-get-upgrade">
- <glossterm>apt-get upgrade</glossterm>
+ <glossentry id="apt-upgrade">
+ <glossterm>apt upgrade</glossterm>
<glossdef><para>Install newest versions of all packages
currently installed.</para></glossdef>
</glossentry>
- <glossentry id="apt-get-dist-upgrade">
- <glossterm>apt-get dist-upgrade</glossterm>
- <glossdef><para>Like <command>apt-get upgrade</command>, but
+ <glossentry id="apt-full-upgrade">
+ <glossterm>apt full-upgrade</glossterm>
+ <glossdef><para>Like <command>apt upgrade</command>, but
with advanced conflict resolution.</para></glossdef>
</glossentry>
- <glossentry id="apt-get-remove">
- <glossterm>apt-get remove
+ <glossentry id="apt-remove">
+ <glossterm>apt remove
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>Remove packages with all needed
packages.</para></glossdef>
</glossentry>
- <glossentry id="apt-get-autoremove">
- <glossterm>apt-get autoremove</glossterm>
+ <glossentry id="apt-autoremove">
+ <glossterm>apt autoremove</glossterm>
<glossdef><para>Remove packages that no other packages depend
on.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-depends">
- <glossterm>apt-cache depends
+ <glossentry id="apt-depends">
+ <glossterm>apt depends
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>List all packages needed by the one
given.</para></glossdef>
</glossentry>
- <glossentry id="apt-cache-rdepends">
- <glossterm>apt-cache rdepends
+ <glossentry id="apt-rdepends">
+ <glossterm>apt rdepends
<replaceable>package-names</replaceable></glossterm>
<glossdef><para>List all packages that need the one
given.</para></glossdef>
@@ -571,37 +569,4 @@
</glossentry>
</glosslist>
</section>
- <section id="apache2">
- <title>Web Server (Apache2)</title>
- <glosslist>
- <glossentry id="etc-apache2">
- <glossterm><filename>/etc/apache2/</filename></glossterm>
- <glossdef><para>Configuration files.</para></glossdef>
- </glossentry>
- <glossentry id="etc-apache2-sites-available">
- <glossterm><filename>/etc/apache2/sites-available/</filename></glossterm>
- <glossdef><para>Contains virtual hosts. To enable a virtual
- host, use <command>a2ensite</command>.</para></glossdef>
- </glossentry>
- <glossentry id="etc-apache2-mods-available">
- <glossterm><filename>/etc/apache2/mods-available/</filename></glossterm>
- <glossdef><para>Contains available modules files. To enable a
- module, use <command>a2enmod</command>.</para></glossdef>
- </glossentry>
- </glosslist>
- </section>
- <section id="samba">
- <title>File and Print Server (Samba)</title>
- <glosslist>
- <glossentry id="etc-samba-smb-conf">
- <glossterm><filename>/etc/samba/smb.conf</filename></glossterm>
- <glossdef><para>Main configuration file.</para></glossdef>
- </glossentry>
- <glossentry id="smbclient">
- <glossterm>smbclient</glossterm>
- <glossdef><para>Browse SMB network resources, e.g. download,
- upload files.</para></glossdef>
- </glossentry>
- </glosslist>
- </section>
</article>
Index: refcard.dbk
===================================================================
--- refcard.dbk (Revision 11072)
+++ refcard.dbk (Arbeitskopie)
@@ -44,6 +44,10 @@
<othername>Martin</othername>
<surname>Borgert</surname>
</editor>
+ <editor>
+ <firstname>Holger</firstname>
+ <surname>Wansing</surname>
+ </editor>
<legalnotice>
<para>This document may be used under the terms the GNU General
Public License version 3 or higher. The license text can be found at <ulink
@@ -53,6 +57,12 @@
</legalnotice>
<revhistory>
<revision>
+ <revnumber>9.0 for Debian 9 'Stretch' -- </revnumber>
+ <date>2016-03-24</date>
+ <revremark>Change versioning scheme; updated content matching
+ Stretch; drop Samba/Apache/m-a/make-kpkg content.</revremark>
+ </revision>
+ <revision>
<revnumber>5.0.9</revnumber>
<date>2013-10-10</date>
<revremark>New and updated translations.</revremark>
Reply to: