The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
PERLANCAR / Perinci-CmdLine-POD-0.039 / Changes 
0.039   2023-07-09  Released-By: PERLANCAR; Urgency: medium

        - Remove usage of smartmatch.

        - Return usage in func.usage also so it can be used separately.


0.038   2022-10-27  Released-By: PERLANCAR; Urgency: medium

        - In showing examples, Replace *all* occurrences of '[[prog]]'
          instead of only one.


0.037   2022-10-15  Released-By: PERLANCAR; Urgency: medium

        - Tweaks.


0.036   2022-10-15  Released-By: PERLANCAR; Urgency: medium

        - [ux] In generated option's POD, use '(No description)' as
          description when there is no description, to avoid ambiguity.


0.035   2022-10-12  Released-By: PERLANCAR; Urgency: medium

        - Show other usage lines (from common_opts that are to be used on
          their own).


0.034   2022-08-12  Released-By: PERLANCAR; Urgency: medium

        - Tweak usage in Synopsis: remove shell prompt. Shell prompt is still
          displayed in the Examples section.


0.033   2022-07-29  Released-By: PERLANCAR; Urgency: medium

        - Render x.doc.faq.


0.032   2022-07-03  Released-By: PERLANCAR; Urgency: medium

        - Change formatting of generated FILES section (now uses =head2 for
          each file).


0.031   2022-07-01  Released-By: PERLANCAR; Urgency: medium

        - [bugfix] Override CLI script's program_name and env_name from
          argument.


0.030   2022-07-01  Released-By: PERLANCAR; Urgency: medium

        - Observe and render x.envs.


0.029   2022-06-13  Released-By: PERLANCAR; Urgency: medium

        - Format generated EXAMPLES section with subheading for each
          example, and include the example's description.


0.028   2022-05-28  Released-By: PERLANCAR; Urgency: medium

        - [bugfix] Option description was not formatted (from Markdown) to
          POD yet.


0.027   2022-05-14  Released-By: PERLANCAR; Urgency: medium

        - Remove superfluous paragraph 'Usage:' in the generated SYNOPSIS
          section because SYNOPSIS *is* for displaying usage. This will make CLI
          scripts' generated doc follow Unix manpage convention more closely.


0.026   2022-05-08  Released-By: PERLANCAR; Urgency: medium

	- [ux] In generated Synopsis, helpfully refer to the generated EXAMPLES
	  section if CLI has examples.


0.025   2021-08-22  Released-By: PERLANCAR; Urgency: medium

	- Remove superfluous paragraph 'Examples:' in the EXAMPLES section.


0.024   2021-08-22  Released-By: PERLANCAR; Urgency: medium

	- Move generated examples from SYNOPSIS section to EXAMPLES
	  section.


0.023   2021-07-10  Released-By: PERLANCAR; Urgency: high

	- Merge releases 0.022 and 0.022.1.


0.022.1 2021-07-10  Released-By: PERLANCAR; Urgency: medium

	- [ux] Use POD-formatted usage line from
	  Perinci::Sub::To::CLIDocData 0.297.

	- Mention support for [env=VARNAME=value] section in the generated POD.

        - UPDATE 2021-07-10: rename release from 0.022 to 0.022.1 due to
          conflict.


0.022   2021-05-07  Released-By: PERLANCAR; Urgency: medium

	- Note command-line options that can be specified as command-line
	  arguments ('pos' defined).

	- Mention support for [env=VARNAME=value] section in the generated POD.


0.021   2020-10-21  Released-By: PERLANCAR; Urgency: medium

	- Fix generated examples.


0.020   2020-10-21  Released-By: PERLANCAR; Urgency: medium

	- In generated 'CONFIGURATION FILE' POD section, mention about
	  loading and configuring plugins.


0.019   2020-05-30  Released-By: PERLANCAR; Urgency: high

        - Merge releases 0.018 & 0.018.1.


0.018.1 2020-05-29  Released-By: PERLANCAR; Urgency: medium

	- Wrap generated usage line.

        - UPDATE 2020-05-30: renamed to 0.018.1 due to conflict.


0.018   2020-04-27  Released-By: PERLANCAR; Urgency: medium

	- Wrap usage line because it's now potentially long, since
	  Perinci::Sub::To::CLIDocData lists all options instead of just
	  '[options]'.

	- In addition to rendering schema clause 'in' into 'Valid values',
	  also render schema clause 'examples' into 'Example value values'.


0.017   2019-01-25  Released-By: PERLANCAR

	- [bugfix] Handle naked result in example specification.


0.016   2017-08-25  Released-By: PERLANCAR

	- [Bugfix] Show subcommand name in example.


0.015   2017-08-12  Released-By: PERLANCAR

	- Use description.alt.env.cmdline before description.


0.014   2017-07-07  Released-By: PERLANCAR

	- Replace recommendation that mentions DZP:GenShellCompletion with
	  cpanm-shcompgen.

	- Accept 'libs' option to pass to Perinci::CmdLine::Dump.

	- [dist] Enable static install.


0.013   2017-06-08  Released-By: PERLANCAR

	- [ux] Consistency in formatting for headings 'Configuration for
	  subcommand ...' and 'Options for subcommand ...'.


0.012   2017-02-27  Released-By: PERLANCAR

	- [ux] Show how many lines were snipped in a long example output.


0.011   2017-02-24  Released-By: PERLANCAR

	- [Bugfix] Apply x.doc.max_result_lines even though example don't
	  use src/src_plang.


0.010   2017-02-24  Released-By: PERLANCAR

	- [Bugfix] Regression which caused examples to not be shown when
	  CLI has no subcommands.

	- Avoid undef warning if --program-name not specified.


0.009   2017-02-13  Released-By: PERLANCAR

	- [Bugfix] If completer name equals program name, say it as self
	  completing, don't say it has a companion completer script.


0.008   2017-01-27  Released-By: PERLANCAR

        - Add options --(no-)gen-subcommands and --gen-subcommand=NAME to allow
          splitting each subcommand's CLI to its own POD/manpage.

        - [ux] Tweak option categories.


0.007   2017-01-14  Released-By: PERLANCAR

	- [Bugfix] Missed empty line after COMPLETION POD section.


0.006   2017-01-13  Released-By: PERLANCAR

	- [Bugfix] Fixes bug which broke generating POD for scripts where the
          Rinci metadata is put inside them.


0.005   2017-01-13  Released-By: PERLANCAR

	- [Bugfix] Set the correct program name to generate the correct
	  default env name and default config filenames.


0.004   2017-01-12  Released-By: PERLANCAR

	- [Bugfix] Forgot to require Markdown::To::POD in two blocks.


0.003   2017-01-11  Released-By: PERLANCAR

	- Generate COMPLETION section.

	- Tweak: put ENVIRONMENT section after CONFIGURATION FILE.

	- Tweak: put FILES section after CONFIGURATION FILE.


0.002   2017-01-11  Released-By: PERLANCAR

	- [Incompatible change] Return each content section as string, not
	  array of strings.


0.001   2017-01-10  Released-By: PERLANCAR

         - First release.