labwc/docs/meson.build

scdoc = find_program('scdoc', required: get_option('man-pages'))

if scdoc.found()
  manpages = [
    'labwc.1',
    'labwc-actions.5',
    'labwc-config.5',
    'labwc-menu.5',
    'labwc-theme.5',
    'labnag.1',
  ]
  foreach manpage : manpages
    markdown = manpage + '.scd'
    custom_target(
      manpage,
      input: markdown,
      output: manpage,
      command: scdoc,
      feed: true,
      capture: true,
      install: true,
      install_dir: join_paths(get_option('mandir'), 'man' + manpage.split('.')[-1])
    )
  endforeach
endif

install_data(
  [
    'autostart',
    'environment',
    'menu.xml',
    'README',
    'shutdown',
    'themerc',
    'rc.xml',
    'rc.xml.all'
  ],
  install_dir: get_option('datadir') / 'doc' / meson.project_name()
)
Convert man pages from md to scd 2021-03-05 22:14:02 +00:00			`scdoc = find_program('scdoc', required: get_option('man-pages'))`
Add labwc(5) 2020-07-22 21:58:27 +01:00
Convert man pages from md to scd 2021-03-05 22:14:02 +00:00			`if scdoc.found()`
build: refactor in preparation for man page not beginning with 'labwc-' No functional change intended. 2025-04-28 20:33:50 +01:00			`manpages = [`
			`'labwc.1',`
			`'labwc-actions.5',`
			`'labwc-config.5',`
			`'labwc-menu.5',`
			`'labwc-theme.5',`
Add labnag Based on swaynag (https://github.com/swaywm/sway/tree/master/swaynag) Copied at commit: https://github.com/swaywm/sway/commit/03483ff3707a358d935e451d39748e58c205ce8a Contains the following modifiations: - Some functional changes including: - Disable exclusive-zone by default (Written-by: @Consolatis) and add command line option -x\|--exclusive-zone - Add close timeout (Written-by: @Consolatis) and -t\|--timeout option - Use index of button (from right-to-left) for exit code - Disable reading from config file and remove associated --type option - Refactoring including: - Use wlr_log() instead of the log.{c,h} functions - Use wl_list instead of sway's list.c implementation - In the pango wrapper functions, use glib's g_strdup_vprintf() rather than the original stringop.c functions - Align with labwc coding style to pass checkpatch.pl - Re-licenced from MIT to GPL-2.0, and add Copyright notices for original authors v2 - Remove option -s\|--dismiss-button and the default "X" button. To get such a button, "-Z X :" - Remove options -b and -z because there is no requirement to run in a terminal. - Remove *-no-terminal from options --button and --button-dismiss because commands are now always run directly without a terminal. v3 - Allow -B/-Z options without action-argument - Invert button order of -B/-Z so that `labnag -m foo -Z x -Z y -Z z` results in three buttons with "x" furthest to the left, and "z" on the right (rather than the other way around). - Use signalfd() to prevent race conditions on SIGTERM v4 - Limit number of stdin lines to 200 to avoid hogging CPU Co-Authored-by: tokyo4j 2025-04-28 20:38:19 +01:00			`'labnag.1',`
Add labwc-environment(5) 2021-04-10 09:17:41 +01:00			`]`
build: refactor in preparation for man page not beginning with 'labwc-' No functional change intended. 2025-04-28 20:33:50 +01:00			`foreach manpage : manpages`
			`markdown = manpage + '.scd'`
Add labwc(5) 2020-07-22 21:58:27 +01:00			`custom_target(`
			`manpage,`
Convert man pages from md to scd 2021-03-05 22:14:02 +00:00			`input: markdown,`
Add labwc(5) 2020-07-22 21:58:27 +01:00			`output: manpage,`
build: remove scdoc stdin/stdout hack From version 0.59.0, meson supports feeding the input file as stdin. See sway@9727db67 2021-09-22 20:21:00 +01:00			`command: scdoc,`
			`feed: true,`
Add labwc(5) 2020-07-22 21:58:27 +01:00			`capture: true,`
			`install: true,`
build: refactor in preparation for man page not beginning with 'labwc-' No functional change intended. 2025-04-28 20:33:50 +01:00			`install_dir: join_paths(get_option('mandir'), 'man' + manpage.split('.')[-1])`
Add labwc(5) 2020-07-22 21:58:27 +01:00			`)`
			`endforeach`
			`endif`
docs: install example configs 2022-11-25 03:13:16 +01:00
			`install_data(`
			`[`
			`'autostart',`
			`'environment',`
			`'menu.xml',`
docs: add basic README 2022-11-28 11:46:56 +01:00			`'README',`
docs: add example shutdown file Closes #1809 2024-06-01 23:24:27 +02:00			`'shutdown',`
theme: support theme setting override ...by reading <config-dir>/themerc-override where <config-dir> is normally $HOME/.config/labwc can be other locations as described in labwc-config(5) and can also be specified by the command line option -C. The reason for supporting theme override is to give users more fine- grained control of settings without making local copies and modifying themes. 2022-12-05 21:46:16 +00:00			`'themerc',`
docs: install example configs 2022-11-25 03:13:16 +01:00			`'rc.xml',`
			`'rc.xml.all'`
			`],`
			`install_dir: get_option('datadir') / 'doc' / meson.project_name()`
			`)`