systemd/man/path-documents.c

/* SPDX-License-Identifier: MIT-0 */

#include <stdio.h>
#include <stdlib.h>
#include <sd-path.h>

int main(void) {
  int r;
  char *t;

  r = sd_path_lookup(SD_PATH_USER_DOCUMENTS, NULL, &t);
  if (r < 0)
    return EXIT_FAILURE;

  printf("~/Documents: %s\n", t);
  free(t);

  return EXIT_SUCCESS;
}
man: change license of examples to MIT-0 Quoting Richard Fontana in [1]: CC0 has been listed by Fedora as a 'good' license for code and content (corresponding to allowed and allowed-content under the new system). We plan to classify CC0 as allowed-content only, so that CC0 would no longer be allowed for code. Over a long period of time a consensus has been building in FOSS that licenses that preclude any form of patent licensing or patent forbearance cannot be considered FOSS. CC0 has a clause that says: "No trademark or patent rights held by Affirmer are waived, abandoned, surrendered, licensed or otherwise affected by this document." (The trademark side of that clause is nonproblematic from a FOSS licensing norms standpoint.) The regular Creative Commons licenses have similar clauses. For the case of our documentation snippets, patent issues do not matter much. But it is always nicer to have a license that is considerred acceptable without any further considerations. So let's change the license to the (now recommended replacement) MIT-0. [1] https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/message/NO7KGDNL5GX3KCB7T3XTGFA3QPSUJA6R/ Using 'git blame -b' and 'git log -p --follow', I identified the following folks as having made non-trivial changes to those snippets: Lennart Poettering Tom Gundersen Luca Bocassi Zbigniew Jędrzejewski-Szmek Thomas Mühlbacher Daan De Meyer I'll ask for confirmation in the pull request. 2022-10-26 08:02:14 +02:00			`/* SPDX-License-Identifier: MIT-0 */`
man: add licenses to all files that lack one Documentation is licensed under LGPL-2.1-or-later. Scripts are MIT to facilitate reuse. Examples are relicensed to CC0-1.0 to maximise copy-and-paste for users, with permission from authors. 2021-10-01 11:44:33 +01:00
man: add sd_path_lookup(3) 2020-03-23 20:36:41 +01:00			`#include <stdio.h>`
man: Don't leak memory in path-documents example The `sd_path_lookup(3)` man page states that the returned string shall be `free(3)`'d but then doesn't do so in the example code. Also add basic error handling as well. 2021-08-30 16:16:30 +02:00			`#include <stdlib.h>`
man: add sd_path_lookup(3) 2020-03-23 20:36:41 +01:00			`#include <sd-path.h>`

			`int main(void) {`
man: Don't leak memory in path-documents example The `sd_path_lookup(3)` man page states that the returned string shall be `free(3)`'d but then doesn't do so in the example code. Also add basic error handling as well. 2021-08-30 16:16:30 +02:00			`int r;`
man: add sd_path_lookup(3) 2020-03-23 20:36:41 +01:00			`char *t;`

man: Don't leak memory in path-documents example The `sd_path_lookup(3)` man page states that the returned string shall be `free(3)`'d but then doesn't do so in the example code. Also add basic error handling as well. 2021-08-30 16:16:30 +02:00			`r = sd_path_lookup(SD_PATH_USER_DOCUMENTS, NULL, &t);`
			`if (r < 0)`
			`return EXIT_FAILURE;`

man: add sd_path_lookup(3) 2020-03-23 20:36:41 +01:00			`printf("~/Documents: %s\n", t);`
man: Don't leak memory in path-documents example The `sd_path_lookup(3)` man page states that the returned string shall be `free(3)`'d but then doesn't do so in the example code. Also add basic error handling as well. 2021-08-30 16:16:30 +02:00			`free(t);`

			`return EXIT_SUCCESS;`
man: add sd_path_lookup(3) 2020-03-23 20:36:41 +01:00			`}`