summaryrefslogtreecommitdiffstats
path: root/docs/PORTABILITY_AND_STABILITY.md (follow)
Commit message (Collapse)AuthorAgeFilesLines
* docs: list all public headers in stability promiseZbigniew Jędrzejewski-Szmek2023-05-161-2/+9
| | | | | | | We provide the same stability for all the headers that are public. Also, mark id128 as portable to other systems. There is really nothing in the code that would make it hard. It would probably work out-of-the-box.
* docs, man: consistently use comma after "For example"Dmitry V. Levin2023-01-231-1/+1
|
* tree-wide: replace obsolete wiki links with systemd.io/manpagesBenjamin Franzke2022-05-211-5/+5
| | | | | | | | | | | All wiki pages that contain a deprecation banner pointing to systemd.io or manpages are updated to point to their replacements directly. Helpful command for identification of available links: git grep freedesktop.org/wiki | \ sed "s#.*\(https://www.freedesktop.org/wiki[^ $<'\\\")]*\)\(.*\)#\\1#" | \ sort | uniq
* docs: use relative linksBenjamin Franzke2022-05-181-8/+8
| | | | | | | | | | | | | | | | Allows for links to work both on systemd.io (or forks) and when viewed on https://github.com/systemd/systemd/tree/main/docs Note that the markdown links are converted by jekyll-relative-links[1] to html. This plugin is enabled by default on github pages[2][3]. Due to a bug in jekyll-relative-links – see https://github.com/benbalter/jekyll-relative-links/issues/61 – we need to avoid line-wrapped links when using relative markdown links. [1] https://github.com/benbalter/jekyll-relative-links [2] https://github.blog/2016-12-05-relative-links-for-github-pages/ [3] https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#plugins
* docs: promise stability for the journal json format tooZbigniew Jędrzejewski-Szmek2022-01-121-0/+1
|
* man+docs: adjust links to the new pageZbigniew Jędrzejewski-Szmek2022-01-121-1/+1
|
* docs: add spdx tags to all .md filesZbigniew Jędrzejewski-Szmek2021-09-271-0/+1
| | | | | | I have no idea if this is going to cause rendering problems, and it is fairly hard to check. So let's just merge this, and if it github markdown processor doesn't like it, revert.
* tree-wide: fix links to systemd.io pagesZbigniew Jędrzejewski-Szmek2021-02-191-3/+3
| | | | | Having the extra slash at the end is not a problem, just inconsistent. But the links with .html or .md return 404.
* man: move content from the wiki to systemd.preset(5)Zbigniew Jędrzejewski-Szmek2021-02-021-1/+1
| | | | | | | | | | The wiki was slightly stale, and almost all the information there was already present in the man page. I moved the remaing part (discussion) into the man page and adjusted all links to point to the man page instead. daemon(7) has a some examples of packaging scriptlets… I don't think it fits there very well. Most likely they should be moved to systemd.preset(5) or maybe even removed, but I'm leaving that for later.
* tree-wide: update web link to logind descriptionZbigniew Jędrzejewski-Szmek2020-10-191-1/+1
| | | | | https://www.freedesktop.org/wiki/Software/systemd/multiseat/ says that it is obsoleted by sd-login(3), so it doesn't make much sense to link to the former.
* docs: update old documentation linksnl67202020-09-291-3/+3
|
* docs: import journal file format docs from fdo wikiLennart Poettering2020-06-251-1/+1
| | | | Just an import, with no textual changes (some fixed URLs however)
* docs: use "polkit" to refer to PolicyKitZbigniew Jędrzejewski-Szmek2020-04-211-1/+1
| | | | | | See d35f51ea848ca76bd3747db69e8c5dd864e82bc3 for justification. First use in each file is turned into a link to the documentation page.
* docs: add .link/.network/.netdev files to interface stability chartZbigniew Jędrzejewski-Szmek2020-03-031-0/+2
| | | | Fixes #9850.
* Fixed some typos in the documentationEmmanuel Bourg2020-01-211-2/+2
|
* docs: uppercase are headersLennart Poettering2020-01-171-1/+1
| | | | We do this in most cases, do so here too.
* docs: let's reduce our spurious whitespace a bitLennart Poettering2020-01-171-2/+0
|
* docs: in PORTABILITY_AND_STABILITY only use one h1Lennart Poettering2020-01-171-2/+2
| | | | | | According to the designer of the page layout a page only should have one h1 header, and everything else should be h2, h3, … I think that makes a ton of sense, hence let's downgrade some headers here.
* docs: say that journalctl --flush/--sync also require journaldZbigniew Jędrzejewski-Szmek2020-01-131-3/+5
| | | | https://github.com/systemd/systemd/pull/14549#pullrequestreview-341758182
* docs: various small fixes to PORTABILITY_AND_STABILITY markdownLennart Poettering2020-01-131-12/+19
| | | | | | Nothing particularly world moving. Follow-up for #14549
* docs: say that various cli progs are independent of pid1Zbigniew Jędrzejewski-Szmek2020-01-121-0/+23
|
* docs: say that dbus api is stable (but list various caveats)Zbigniew Jędrzejewski-Szmek2020-01-121-1/+1
| | | | | I removed the part about sysv compat, because that has already been removed and we don't make any use of conditional dbus interfaces afaict.
* docs: say that all documented programs in $PATH are stableZbigniew Jędrzejewski-Szmek2020-01-121-2/+2
|
* docs: import "interface stability promise"Zbigniew Jędrzejewski-Szmek2020-01-121-45/+75
| | | | | | | | | In the wiki, this was a separate page. I don't think this split is useful, since the information about what is stable and what not seems randomly split between the two pages. Links are adjusted for our own pages. Some external links to gentoo and other projects seem to be broken, but it's a chore to fix them.
* docs/stability: relax the stance on accepting patches a bitZbigniew Jędrzejewski-Szmek2020-01-111-4/+4
| | | | | | | | Instead of saying that patches for portability are not accepted, say that this is decided case-by-case. This is what happens in practice, and we tend to discuss each patch on its own merits. Some sentences are reworded a bit where they sound awkward.
* docs: import stability chart from wikiZbigniew Jędrzejewski-Szmek2020-01-111-0/+100
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-29 21:57:47 +0100