summaryrefslogtreecommitdiff
path: root/man/os-release.xml
AgeCommit message (Collapse)Author
2016-06-06os-release: Add VERSION_CODENAME field (#3445)Benjamin Drung
Debian and their derivatives (Ubuntu, Trisquel, etc.) use a code name for their repositories. Thus record the code name in os-release for processing. Closes systemd/systemd#3429
2015-11-06doc: correct punctuation and improve typography in documentationJan Engelhardt
2015-09-07man: clarify wording of os-release.CPE_NAMEDavid Herrmann
We expect the CPE_NAME to be formatted in URI binding syntax. Make that clear in the documentation. Furthermore, the CPE-spec has been taken over by NIST, so adjust the links as well. Reported by: Ben Harris <bjh21@cam.ac.uk>
2015-06-18man: revert dynamic paths for split-usr setupsTom Gundersen
This did not really work out as we had hoped. Trying to do this upstream introduced several problems that probably makes it better suited as a downstream patch after all. At any rate, it is not releaseable in the current state, so we at least need to revert this before the release. * by adjusting the path to binaries, but not do the same thing to the search path we end up with inconsistent man-pages. Adjusting the search path too would be quite messy, and it is not at all obvious that this is worth the effort, but at any rate it would have to be done before we could ship this. * this means that distributed man-pages does not make sense as they depend on config options, and for better or worse we are still distributing man pages, so that is something that definitely needs sorting out before we could ship with this patch. * we have long held that split-usr is only minimally supported in order to boot, and something we hope will eventually go away. So before we start adding even more magic/effort in order to make this work nicely, we should probably question if it makes sense at all.
2015-05-28man: generate configured paths in manpagesFilipe Brandenburger
In particular, use /lib/systemd instead of /usr/lib/systemd in distributions like Debian which still have not adopted a /usr merge setup. Use XML entities from man/custom-entities.ent to replace configured paths while doing XSLT processing of the original XML files. There was precedent of some files (such as systemd.generator.xml) which were already using this approach. This addresses most of the (manual) fixes from this patch: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/patches/Fix-paths-in-man-pages.patch?h=experimental-220 The idea of using generic XML entities was presented here: http://lists.freedesktop.org/archives/systemd-devel/2015-May/032240.html This patch solves almost all the issues, with the exception of: - Path to /bin/mount and /bin/umount. - Generic statements about preference of /lib over /etc. These will be handled separately by follow up patches. Tested: - With default configure settings, ran "make install" to two separate directories and compared the output to confirm they matched exactly. - Used a set of configure flags including $CONFFLAGS from Debian: http://anonscm.debian.org/cgit/pkg-systemd/systemd.git/tree/debian/rules Installed the tree and confirmed the paths use /lib/systemd instead of /usr/lib/systemd and that no other unexpected differences exist. - Confirmed that `make distcheck` still passes.
2015-05-05Add VARIANT as a standard value for /etc/os-releaseStephen Gallagher
Some distributions (such as Fedora) are using the VARIANT field to indicate to select packages which of several default configurations they should be using. For example, VARIANT=Server provides a different default firewall configuration (blocking basically everything but SSH and the management console) whereas VARIANT=Workstation opens many other ports for application compatibility. By adding this patch to the manual pages, we can standardize on a cross-distribution mechanism for accomplishing this. Fedora implementation details are available at https://fedoraproject.org/wiki/Packaging:Per-Product_Configuration (David: drop double paranthesis)
2015-04-29man: avoid line break in urlLennart Poettering
2015-03-13man: fix a bunch of linksZbigniew Jędrzejewski-Szmek
All hail linkchecker!
2015-02-10man: boilerplate unificationZbigniew Jędrzejewski-Szmek
2015-02-03Reindent man pages to 2chZbigniew Jędrzejewski-Szmek
2015-01-15os-release: Add PRIVACY_POLICY_URLBastien Nocera
2014-12-25doc: os-release: mention all shell characters that must be escapedMantas Mikulėnas
Since the manpage already talks about shell-compatibility, it should be more accurate about what needs to be escaped and how.
2014-10-08note on relative symlink in os-releaseRahul Sundaram
2014-06-28doc: grammatical correctionsJan Engelhardt
2014-06-13os-release: define /usr/lib/os-release as fallback for /etc/os-releaseLennart Poettering
The file should have been in /usr/lib/ in the first place, since it describes the OS container in /usr (and not the configuration in /etc), hence, let's support os-release files in /usr/lib as fallback if no version in /etc exists, following the usual override logic. A prior commit already enabled tmpfiles to create /etc/os-release as a symlink to /usr/lib/os-release should it be missing, thus providing nice compatibility with applications only checking in /etc. While it's probably a good idea if all apps check both locations via a fallback logic, it is only necessary in the early boot process, as long as the /etc/os-release symlink has not been restored, in case we boot with an empty /etc.
2013-09-12man: wording and grammar updatesJan Engelhardt
This is a recurring submission and includes corrections to various issue spotted. I guess I can just skip over reporting ubiquitous comma placement fixes… Highligts in this particular commit: - the "unsigned" type qualifier is completed to form a full type "unsigned int" - alphabetic -> lexicographic (that way we automatically define how numbers get sorted)
2013-07-16man: use HTTPS links for links that support itJason St. John
2013-07-02man: improve grammar and word formatting in numerous man pagesJason St. John
Use proper grammar, word usage, adjective hyphenation, commas, capitalization, spelling, etc. To improve readability, some run-on sentences or sentence fragments were revised. [zj: remove the space from 'file name', 'host name', and 'time zone'.]
2013-03-27man/os-release: Add BUILD_ID fieldWilliam Douglas
BUILD_ID is a fairly generic field used to identify the system image that was used to install the distribution.
2012-10-16Reword sentences that contain psuedo-English "resp."Andrew Eikum
As you likely know, Arch Linux is in the process of moving to systemd. So I was reading through the various systemd docs and quickly became baffled by this new abbreviation "resp.", which I've never seen before in my English-mother-tongue life. Some quick Googling turned up a reference: <http://www.transblawg.eu/index.php?/archives/870-Resp.-and-other-non-existent-English-wordsNicht-existente-englische-Woerter.html> I guess it's a literal translation of the German "Beziehungsweise", but English doesn't work the same way. The word "respectively" is used exclusively to provide an ordering connection between two lists. E.g. "the prefixes k, M, and G refer to kilo-, mega-, and giga-, respectively." It is also never abbreviated to "resp." So the sentence "Sets the default output resp. error output for all services and sockets" makes no sense to a natural English speaker. This patch removes all instances of "resp." in the man pages and replaces them with sentences which are much more clear and, hopefully, grammatically valid. In almost all instances, it was simply replacing "resp." with "or," which the original author (Lennart?) could probably just do in the future. The only other instances of "resp." are in the src/ subtree, which I don't feel privileged to correct. Signed-off-by: Andrew Eikum <aeikum@codeweavers.com>
2012-09-13docs: typo fixes in logind.conf.xml and os-release.xmlThomas Hindoe Paaboel Andersen
https://bugs.freedesktop.org/show_bug.cgi?id=54501
2012-04-12relicense to LGPLv2.1 (with exceptions)Lennart Poettering
We finally got the OK from all contributors with non-trivial commits to relicense systemd from GPL2+ to LGPL2.1+. Some udev bits continue to be GPL2+ for now, but we are looking into relicensing them too, to allow free copy/paste of all code within systemd. The bits that used to be MIT continue to be MIT. The big benefit of the relicensing is that closed source code may now link against libsystemd-login.so and friends.
2012-03-06man: clarify that applications must ignore unknown fieldsLennart Poettering
2012-03-06man: document how os-release(5) may be extended by OS vendorsLennart Poettering
2012-03-06man: fix typoLennart Poettering
2012-03-06man: allow that /etc/os-release is a symlinkLennart Poettering
2012-03-06man: add URL field definitions to os-release(5)Lennart Poettering
As requested by Raphaël Hertzog from the Debian project, include information about the home page and support/bug report pages in /etc/os-release.
2012-03-06man: add ID_LIKE definition to os-release(5)Lennart Poettering
As requested by Raphaël Hertzog from the Debian project, encode derivative information in /etc/os-release.
2012-02-14man: define more precisely the format of /etc/os-releaseLennart Poettering
2012-02-14man: document CPE field in os-release fileLennart Poettering
2012-02-13man: we don't support systems without /etc/os-release anymoreLennart Poettering
2012-02-13man: it's probably a good idea to wrap the ANSI color in quotes, in order to ↵Lennart Poettering
allow proper shell parsing of the semicolon
2011-06-15man: clarify os-release in regards to spaces a bitLennart Poettering
2011-04-21man: minor fixesLennart Poettering
2011-04-16hostnamed: introduce systemd-hostnamedLennart Poettering
http://www.freedesktop.org/wiki/Software/systemd/hostnamed
2010-12-20Fix misspellings in os-release manpage and hwclock-load.serviceMiklos Vajna
2010-11-22man: make clear that VERSION and VERSION_ID is not mandatory in os-release.5Lennart Poettering
2010-11-21man: document /etc/os-releaseLennart Poettering