summaryrefslogtreecommitdiffstats
path: root/Documentation
Commit message (Collapse)AuthorAgeFilesLines
* Spelling fixes.Ville Skyttä2013-04-081-1/+1
| | | | Signed-off-by: Ville Skyttä <ville.skytta@iki.fi>
* bash-completion: add completion files to Makefile.amSami Kerola2013-04-011-3/+4
| | | | | | And remove shell completion TODO item. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: add note about /var/lib/hwclock to TODOKarel Zak2013-03-261-0/+7
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: arch is gone, use delpart as usage() function exampleSami Kerola2013-03-261-1/+1
| | | | | | The arch.c was removed in commit 27abd809. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: upadte v2.23-ReleaseNotesKarel Zak2013-03-221-10/+8Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: add v2.23-ReleaseNotesKarel Zak2013-03-221-0/+976
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: add wipefs feature request to TODOKarel Zak2013-03-191-0/+5
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: cleanup TODOKarel Zak2013-03-181-23/+15Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* chkdupexe: remove, deprecated for yearsKarel Zak2013-03-141-6/+0Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* arch: remove the command, deprecated since 2.13, use coreutils versionKarel Zak2013-03-141-8/+0Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update deprecated.txtKarel Zak2013-02-261-0/+11
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* textual: spell and encode the name of Arkadiusz Miśkiewicz correctlyBenno Schulenberg2013-02-064-4/+4
| | | | Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
* docs: usage function and gettextSami Kerola2013-01-251-3/+13
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | I made following survey which was sent to all email addresses in po/ directory that had the on-going millenium as time when translator had been active. There are two quite common styles to write a command usage print out, which one you prefer? 1. Each option as separated translatable string. 18 votes 2. Or the whole thing as one big output. 1 vote 3. No preference. 1 vote The questionaire had also free text field asking 'Why do you prefer that?', and here are the answers. [Separately] It is easier to follow changes with the translations. If you change only one line or two, the big string would change to fuzzy and I have to check the whole thing to see what was changed in the original. If the changed line is a single string, the string to check is a lot shorter. [No preference] Usually, if there is no reason to separate strings, better keep them together so that the context is obvious. In the case at hand, it might help if in some language e.g. one translated line is too wide for the screen. This is unlikely, but... OTOH, with this solution, if you change one string the whole translation will be discarded until a translator comes and updates it... [Separately] It may be a bit harder to get the formatting right, but it is much easier in maintenance. With one option changing, the translator immediately sees the spot. And even with a lazy translator, program author will have all the options translated that have not changed at all. [Separately] First one would be more in elegant I believe [Separately] I prefer to have them separately because they don't form a single text paragraph. In other words, they can be translated separately because they are complete and separate "sentences". Of course consistency of format and word choices need to be taken care of, but the fact that the messages appear next to each other in the PO file should be enough. Also if the options are not translated separately, adding or editing one option causes the translation of all options to become fuzzy and if for some reason it isn't checked before next release (happens sometimes), all of them will show untranslated to the user. [Separately] Translations are a lot easier to update that way. If an option is added, removed or changed, only a small amount of text becomes fuzzy. If everything is in one big output, a lot of text becomes fuzzy, and you have to read a lot more text to discover what exactly changed. [Separately] When updating a fuzzy translation, with one big output it's very tedious and error-prone to find out the reason for fuzziness, i.e. what actually has changed in the msgid. [Separately] Way easier to translate, and especially to spot translation updates when one string gets removed, added or modified. [Separately] Makes translation memory more efficient. Some hard terms in the list don't prevent translation of the whole block. Actually the beginning of the strings don't need any translation ta all before [] part. Information about the context can be provided in comments or the context parameter. [Separately] Please consider the case when a part of string, (= msgid) is changed. It is marked as fuzzy in the .po files, we translators have to check whole sentences for the difference between it and previous version. [Separately] Every sentence must be a separate translation unit. [One big output] for performance to ouput strings [Separately] In the second case, if only one option changes (or a new one is added), the translator will see as if all of the options changed, having to find out which one of them is really new or has actually changed. Also, if the translator has had no time to update the string, only one of the options will be shown in the original language (which is arguably ugly, but better than nothing for many users). [Separately] It's easier to translate the options separately using translation memory. [Separately] Easier to separate and see changes [Separately] more translator friendly [Separately] From the user POV I found the separeted version more interesting because if a maintainer can't update the translation fast enough between releases the user will still get the current translated string with the new ones untraslated. From the translator POV the big output will give more context information as one can see the whole command options. With a new string added while the rest is translated having some context can be more difficult. [Separately] Additions to the list or changes to one options means you don't have to check all lines each time. So unless you have very, _very_ good reason you should not output all usage as one big table. This implies also that when large usage output is changed it should be split to small hunks. That may be a bit more work once, but the next change will pay the extrawork off so never hesitate when splitting. Reference: http://www.surveymonkey.com/s/QKZ75HK Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* mount: add support for x-mount.mkdir[=<mode>] optionOndrej Oprala2013-01-091-2/+0Star
| | | | | | | | | If the target directory (mountpoint) does not exist then mount(8) will create it before mount.<type> is executed or mount(2) syscall is called. Co-Author: Karel Zak <kzak@redhat.com> Signed-off-by: Ondrej Oprala <ooprala@redhat.com> Signed-off-by: Karel Zak <kzak@redhat.com>
* tunelp: deprecation: remove command from default buildSami Kerola2012-12-191-0/+4
| | | | | | It is difficult to think think tunelp command being in use a lot. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* Merge branch '2012wk47' of git://github.com/kerolasa/lelux-utiliteetitKarel Zak2012-11-303-76/+41Star
|\
| * docs: ddate removalSami Kerola2012-11-251-73/+0Star
| | | | | | | | | | | | Missed in commit 4cf02b65109029a38f708148dea8d2bdf2fa19de Signed-off-by: Sami Kerola <kerolasa@iki.fi>
| * docs: mention what Open Group has marked legacySami Kerola2012-11-251-0/+12
| | | | | | | | | | Reviewed-by: Bruce Dubbs <bruce.dubbs@gmail.com> Signed-off-by: Sami Kerola <kerolasa@iki.fi>
| * docs: remove dead linkSami Kerola2012-11-251-3/+0Star
| | | | | | | | Signed-off-by: Sami Kerola <kerolasa@iki.fi>
| * docs: mention Open Group requirementsSami Kerola2012-11-251-0/+29
| | | | | | | | | | | | | | | | | | | | Commands cal col ipcrm ipcs kill line logger mesg more newgrp pg renice has Open Group requirements. Contributors need to be aware of them. Reviewed-by: Adam Sampson <ats@offog.org> Reviewed-by: Bruce Dubbs <bruce.dubbs@gmail.com> Reviewed-by: Ángel González <ingenit@zoho.com> Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* | docs: cleanup TODOKarel Zak2012-11-271-65/+0Star
|/ | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* su: log failed logins to btmpKarel Zak2012-11-221-1/+1
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: mark old losetup output format as DEPRECATEDKarel Zak2012-11-122-6/+18
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update TODO fileKarel Zak2012-11-071-5/+0Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update deprecated fileKarel Zak2012-10-181-15/+0Star
| | | | | | | | | The goal is to consolidate the very basic linux commands and minimize dependence on another packages (e.g. shadow-utils). It seems better to keep newgrp, vipw and vigr as non-deprecated for now. Maybe we will found a way how to improve the code. We will see... :-) Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: remove hwclock --compare from TODOBill Pemberton2012-10-161-21/+0Star
| | | | | | | commit 83765871ef0d6c554c46027577648b77c7351a78 added the --compare option to hwclock so it can be removed from the TODO. Signed-off-by: Bill Pemberton <wfp5p@virginia.edu>
* docs: add su(1) btmp loggingKarel Zak2012-10-161-0/+6
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* ddate: remove from util-linuxSami Kerola2012-10-151-1/+1
| | | | | | | | | | | See RedHat bug for reasons why the ddate is cleaned up. The reference is where to get the command in future. Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=823156 References: https://github.com/bo0ts/ddate Acked-by: Petr Uzel <petr.uzel@suse.cz> Signed-off-by: Sami Kerola <kerolasa@iki.fi> Signed-off-by: Karel Zak <kzak@redhat.com>
* mount: fix a few typosMike Frysinger2012-10-021-1/+1
| | | | | | Nothing of note here. Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* docs: add note about /etc/pam.d/su-l to ReleaseNotesKarel Zak2012-09-051-0/+2
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: add list of expected PAM config filesKarel Zak2012-09-041-0/+31
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update v2.22-ReleaseNotesKarel Zak2012-09-041-2/+18
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update v2.22-ReleaseNotesKarel Zak2012-08-151-4/+77
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update TODOSami Kerola2012-08-061-9/+0Star
| | | | | | | | | | | | Remove tasks that are done. dmesg: --follow option Reference: 0fd12a9697c2e01e3c2e1e558ff027cd2947ee94 build-sys: recursive build Reference: 8772f8d7eeeb922bccee3376552c59d7148df7b4 Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: ftp server does no longer support util-linux-ngSami Kerola2012-08-066-26/+26
| | | | | | | A symlink was probably removed from ftp://ftp.kernel.org/pub/linux/utils/ Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: update tests docsKarel Zak2012-08-031-2/+12
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* build-sys: don't compile lib{mount,blkid} tests when --disable-static specifiedKarel Zak2012-08-021-0/+3
| | | | | | The tests often depend on private (non-API) library functions. Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update howto-tests.txtKarel Zak2012-07-301-8/+9
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* build-sys: move tests to check_PROGRAMSKarel Zak2012-07-301-0/+3
| | | | | | Thanks to Mike Frysinger. Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: add note about enabled kill(1) to v2.22-ReleaseNotesKarel Zak2012-07-301-0/+1
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: add note about partx output changeKarel Zak2012-07-271-0/+5
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* doc: fix typo in v2.22-ReleaseNotesBernhard Voelker2012-07-271-1/+1
| | | | Signed-off-by: Bernhard Voelker <mail@bernhard-voelker.de>
* docs: add v2.22-ReleaseNotesKarel Zak2012-07-271-0/+1095
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: tell about irc channelSami Kerola2012-07-261-0/+10
| | | | | Reference: http://comments.gmane.org/gmane.linux.utilities.util-linux-ng/3550 Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* docs: update TODOKarel Zak2012-07-171-15/+0Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: update TODO fileKarel Zak2012-07-171-15/+3Star
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: fix typos found by misspellingsBernhard Voelker2012-07-091-1/+1
| | | | | | | | | | | | | | | | | | The tool misspellings (https://github.com/lyda/misspell-check) detected several typos. Command used: $ git ls-files | grep -v ^po/ | misspellings -f - * Documentation/releases/v2.18-ReleaseNotes: Fix typo in news entry. * NEWS: Likewise. * config/texinfo.tex: Fix typo in comments. * libmount/src/context.c: Fix typo in comment. * libmount/src/fs.c: Likewise. * login-utils/login.c: Likewise. * login-utils.su.1: Fix typo in man page. * sys-utils/chcpu.c: Fix typo in error message. Signed-off-by: Bernhard Voelker <mail@bernhard-voelker.de>
* docs: add note about non-recursive build-sysKarel Zak2012-06-271-0/+28
| | | | Signed-off-by: Karel Zak <kzak@redhat.com>
* docs: fix email macro in manual exampleSami Kerola2012-05-311-4/+4
| | | | | | URL macro is not email address macro. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
* su: Mention SUID_* feature.Thomas Schwinge2012-05-291-1/+1
| | | | Signed-off-by: Thomas Schwinge <thomas@codesourcery.com>