From: john at keeping.me.uk (John Keeping)
Subject: [PATCH v3 01/17] manpage: fix sorting order
Date: Tue, 19 Jun 2018 22:35:06 +0100 [thread overview]
Message-ID: <20180619213506.GY1922@john.keeping.me.uk> (raw)
In-Reply-To: <152939889153.4492.6986212021084928038.stgit@mail.warmcat.com>
On Tue, Jun 19, 2018 at 05:01:31PM +0800, Andy Green wrote:
> You maybe didn't know you had OCD until you saw an
> alpha sorted list that has stuff out of order in it.
>
> Signed-off-by: Andy Green <andy at warmcat.com>
Reviewed-by: John Keeping <john at keeping.me.uk>
> ---
> cgitrc.5.txt | 176 +++++++++++++++++++++++++++++-----------------------------
> 1 file changed, 88 insertions(+), 88 deletions(-)
>
> diff --git a/cgitrc.5.txt b/cgitrc.5.txt
> index acfae91..f6f6502 100644
> --- a/cgitrc.5.txt
> +++ b/cgitrc.5.txt
> @@ -54,14 +54,10 @@ branch-sort::
> list, and when set to "name" enables ordering by branch name. Default
> value: "name".
>
> -cache-root::
> - Path used to store the cgit cache entries. Default value:
> - "/var/cache/cgit". See also: "MACRO EXPANSION".
> -
> -cache-static-ttl::
> +cache-about-ttl::
> Number which specifies the time-to-live, in minutes, for the cached
> - version of repository pages accessed with a fixed SHA1. See also:
> - "CACHE". Default value: -1".
> + version of the repository about page. See also: "CACHE". Default
> + value: "15".
>
> cache-dynamic-ttl::
> Number which specifies the time-to-live, in minutes, for the cached
> @@ -73,6 +69,10 @@ cache-repo-ttl::
> version of the repository summary page. See also: "CACHE". Default
> value: "5".
>
> +cache-root::
> + Path used to store the cgit cache entries. Default value:
> + "/var/cache/cgit". See also: "MACRO EXPANSION".
> +
> cache-root-ttl::
> Number which specifies the time-to-live, in minutes, for the cached
> version of the repository index page. See also: "CACHE". Default
> @@ -83,22 +83,22 @@ cache-scanrc-ttl::
> of scanning a path for git repositories. See also: "CACHE". Default
> value: "15".
>
> -cache-about-ttl::
> - Number which specifies the time-to-live, in minutes, for the cached
> - version of the repository about page. See also: "CACHE". Default
> - value: "15".
> -
> -cache-snapshot-ttl::
> - Number which specifies the time-to-live, in minutes, for the cached
> - version of snapshots. See also: "CACHE". Default value: "5".
> +case-sensitive-sort::
> + Sort items in the repo list case sensitively. Default value: "1".
> + See also: repository-sort, section-sort.
>
> cache-size::
> The maximum number of entries in the cgit cache. When set to "0",
> caching is disabled. See also: "CACHE". Default value: "0"
>
> -case-sensitive-sort::
> - Sort items in the repo list case sensitively. Default value: "1".
> - See also: repository-sort, section-sort.
> +cache-snapshot-ttl::
> + Number which specifies the time-to-live, in minutes, for the cached
> + version of snapshots. See also: "CACHE". Default value: "5".
> +
> +cache-static-ttl::
> + Number which specifies the time-to-live, in minutes, for the cached
> + version of repository pages accessed with a fixed SHA1. See also:
> + "CACHE". Default value: -1".
>
> clone-prefix::
> Space-separated list of common prefixes which, when combined with a
> @@ -159,12 +159,29 @@ enable-follow-links::
> Flag which, when set to "1", allows users to follow a file in the log
> view. Default value: "0".
>
> +enable-git-config::
> + Flag which, when set to "1", will allow cgit to use git config to set
> + any repo specific settings. This option is used in conjunction with
> + "scan-path", and must be defined prior, to augment repo-specific
> + settings. The keys gitweb.owner, gitweb.category, gitweb.description,
> + and gitweb.homepage will map to the cgit keys repo.owner, repo.section,
> + repo.desc, and repo.homepage respectively. All git config keys that begin
> + with "cgit." will be mapped to the corresponding "repo." key in cgit.
> + Default value: "0". See also: scan-path, section-from-path.
> +
> enable-http-clone::
> - If set to "1", cgit will act as an dumb HTTP endpoint for git clones.
> + If set to "1", cgit will act as a dumb HTTP endpoint for git clones.
> You can add "http://$HTTP_HOST$SCRIPT_NAME/$CGIT_REPO_URL" to clone-url
> to expose this feature. If you use an alternate way of serving git
> repositories, you may wish to disable this. Default value: "1".
>
> +enable-html-serving::
> + Flag which, when set to "1", will allow the /plain handler to serve
> + mimetype headers that result in the file being treated as HTML by the
> + browser. When set to "0", such file types are returned instead as
> + text/plain or application/octet-stream. Default value: "0". See also:
> + "repo.enable-html-serving".
> +
> enable-index-links::
> Flag which, when set to "1", will make cgit generate extra links for
> each repo in the repository index (specifically, to the "summary",
> @@ -195,27 +212,10 @@ enable-subject-links::
> in commit view. Default value: "0". See also:
> "repo.enable-subject-links".
>
> -enable-html-serving::
> - Flag which, when set to "1", will allow the /plain handler to serve
> - mimetype headers that result in the file being treated as HTML by the
> - browser. When set to "0", such file types are returned instead as
> - text/plain or application/octet-stream. Default value: "0". See also:
> - "repo.enable-html-serving".
> -
> enable-tree-linenumbers::
> Flag which, when set to "1", will make cgit generate linenumber links
> for plaintext blobs printed in the tree view. Default value: "1".
>
> -enable-git-config::
> - Flag which, when set to "1", will allow cgit to use git config to set
> - any repo specific settings. This option is used in conjunction with
> - "scan-path", and must be defined prior, to augment repo-specific
> - settings. The keys gitweb.owner, gitweb.category, gitweb.description,
> - and gitweb.homepage will map to the cgit keys repo.owner, repo.section,
> - repo.desc, and repo.homepage respectively. All git config keys that begin
> - with "cgit." will be mapped to the corresponding "repo." key in cgit.
> - Default value: "0". See also: scan-path, section-from-path.
> -
> favicon::
> Url used as link to a shortcut icon for cgit. It is suggested to use
> the value "/favicon.ico" since certain browsers will ignore other
> @@ -251,19 +251,14 @@ logo-link::
> calculated url of the repository index page will be used. Default
> value: none.
>
> -owner-filter::
> - Specifies a command which will be invoked to format the Owner
> - column of the main page. The command will get the owner on STDIN,
> - and the STDOUT from the command will be included verbatim in the
> - table. This can be used to link to additional context such as an
> - owners home page. When active this filter is used instead of the
> - default owner query url. Default value: none.
> - See also: "FILTER API".
> -
> max-atom-items::
> Specifies the number of items to display in atom feeds view. Default
> value: "10".
>
> +max-blob-size::
> + Specifies the maximum size of a blob to display HTML for in KBytes.
> + Default value: "0" (limit disabled).
> +
> max-commit-count::
> Specifies the number of entries to list per page in "log" view. Default
> value: "50".
> @@ -280,10 +275,6 @@ max-repodesc-length::
> Specifies the maximum number of repo description characters to display
> on the repository index page. Default value: "80".
>
> -max-blob-size::
> - Specifies the maximum size of a blob to display HTML for in KBytes.
> - Default value: "0" (limit disabled).
> -
> max-stats::
> Set the default maximum statistics period. Valid values are "week",
> "month", "quarter" and "year". If unspecified, statistics are
> @@ -319,6 +310,15 @@ noheader::
> Flag which, when set to "1", will make cgit omit the standard header
> on all pages. Default value: none. See also: "embedded".
>
> +owner-filter::
> + Specifies a command which will be invoked to format the Owner
> + column of the main page. The command will get the owner on STDIN,
> + and the STDOUT from the command will be included verbatim in the
> + table. This can be used to link to additional context such as an
> + owners home page. When active this filter is used instead of the
> + default owner query url. Default value: none.
> + See also: "FILTER API".
> +
> project-list::
> A list of subdirectories inside of scan-path, relative to it, that
> should loaded as git repositories. This must be defined prior to
> @@ -481,9 +481,6 @@ repo.defbranch::
> repo.desc::
> The value to show as repository description. Default value: none.
>
> -repo.homepage::
> - The value to show as repository homepage. Default value: none.
> -
> repo.email-filter::
> Override the default email-filter. Default value: none. See also:
> "enable-filter-overrides". See also: "FILTER API".
> @@ -492,6 +489,10 @@ repo.enable-commit-graph::
> A flag which can be used to disable the global setting
> `enable-commit-graph'. Default value: none.
>
> +repo.enable-html-serving::
> + A flag which can be used to override the global setting
> + `enable-html-serving`. Default value: none.
> +
> repo.enable-log-filecount::
> A flag which can be used to disable the global setting
> `enable-log-filecount'. Default value: none.
> @@ -508,15 +509,14 @@ repo.enable-subject-links::
> A flag which can be used to override the global setting
> `enable-subject-links'. Default value: none.
>
> -repo.enable-html-serving::
> - A flag which can be used to override the global setting
> - `enable-html-serving`. Default value: none.
> -
> repo.hide::
> Flag which, when set to "1", hides the repository from the repository
> index. The repository can still be accessed by providing a direct path.
> Default value: "0". See also: "repo.ignore".
>
> +repo.homepage::
> + The value to show as repository homepage. Default value: none.
> +
> repo.ignore::
> Flag which, when set to "1", ignores the repository. The repository
> is not shown in the index and cannot be accessed by providing a direct
> @@ -531,10 +531,6 @@ repo.logo-link::
> calculated url of the repository index page will be used. Default
> value: global logo-link.
>
> -repo.owner-filter::
> - Override the default owner-filter. Default value: none. See also:
> - "enable-filter-overrides". See also: "FILTER API".
> -
> repo.module-link::
> Text which will be used as the formatstring for a hyperlink when a
> submodule is printed in a directory listing. The arguments for the
> @@ -559,6 +555,10 @@ repo.owner::
> A value used to identify the owner of the repository. Default value:
> none.
>
> +repo.owner-filter::
> + Override the default owner-filter. Default value: none. See also:
> + "enable-filter-overrides". See also: "FILTER API".
> +
> repo.path::
> An absolute path to the repository directory. For non-bare repositories
> this is the .git-directory. Default value: none.
> @@ -574,6 +574,10 @@ repo.readme::
> are no non-public files located in the same directory as the readme
> file. Default value: <readme>.
>
> +repo.section::
> + Override the current section name for this repository. Default value:
> + none.
> +
> repo.snapshots::
> A mask of snapshot formats for this repo that cgit generates links for,
> restricted by the global "snapshots" setting. Default value:
> @@ -586,10 +590,6 @@ repo.snapshot-prefix::
> of "linux-stable-3.15.4". Default value: <empty> meaning to use
> the repository basename.
>
> -repo.section::
> - Override the current section name for this repository. Default value:
> - none.
> -
> repo.source-filter::
> Override the default source-filter. Default value: none. See also:
> "enable-filter-overrides". See also: "FILTER API".
> @@ -662,30 +662,6 @@ about filter::
> The about text that is to be filtered is available on standard input
> and the filtered text is expected on standard output.
>
> -commit filter::
> - This filter is given no arguments. The commit message text that is to
> - be filtered is available on standard input and the filtered text is
> - expected on standard output.
> -
> -email filter::
> - This filter is given two parameters: the email address of the relevant
> - author and a string indicating the originating page. The filter will
> - then receive the text string to format on standard input and is
> - expected to write to standard output the formatted text to be included
> - in the page.
> -
> -owner filter::
> - This filter is given no arguments. The owner text is available on
> - standard input and the filter is expected to write to standard
> - output. The output is included in the Owner column.
> -
> -source filter::
> - This filter is given a single parameter: the filename of the source
> - file to filter. The filter can use the filename to determine (for
> - example) the syntax highlighting mode. The contents of the source
> - file that is to be filtered is available on standard input and the
> - filtered contents is expected on standard output.
> -
> auth filter::
> The authentication filter receives 12 parameters:
> - filter action, explained below, which specifies which action the
> @@ -712,6 +688,30 @@ auth filter::
> Please see `filters/simple-authentication.lua` for a clear example
> script that may be modified.
>
> +commit filter::
> + This filter is given no arguments. The commit message text that is to
> + be filtered is available on standard input and the filtered text is
> + expected on standard output.
> +
> +email filter::
> + This filter is given two parameters: the email address of the relevant
> + author and a string indicating the originating page. The filter will
> + then receive the text string to format on standard input and is
> + expected to write to standard output the formatted text to be included
> + in the page.
> +
> +owner filter::
> + This filter is given no arguments. The owner text is available on
> + standard input and the filter is expected to write to standard
> + output. The output is included in the Owner column.
> +
> +source filter::
> + This filter is given a single parameter: the filename of the source
> + file to filter. The filter can use the filename to determine (for
> + example) the syntax highlighting mode. The contents of the source
> + file that is to be filtered is available on standard input and the
> + filtered contents is expected on standard output.
> +
>
> All filters are handed the following environment variables:
>
>
> _______________________________________________
> CGit mailing list
> CGit at lists.zx2c4.com
> https://lists.zx2c4.com/mailman/listinfo/cgit
next prev parent reply other threads:[~2018-06-19 21:35 UTC|newest]
Thread overview: 140+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-06-11 7:08 Rendering of README.md inline with inner tree view dirs andy
2018-06-11 7:31 ` list
2018-06-11 7:38 ` andy
2018-06-11 7:53 ` list
2018-06-11 8:05 ` andy
2018-06-11 15:38 ` john
2018-06-12 5:53 ` andy
2018-06-12 8:35 ` list
2018-06-12 9:24 ` john
2018-06-12 9:27 ` andy
2018-06-12 12:07 ` john
2018-06-12 9:31 ` john
2018-06-13 1:47 ` andy
2018-06-13 2:01 ` [PATCH 00/11] Render READMEs inline in tree view andy
2018-06-13 2:01 ` [PATCH 01/11] Use string list strdup_strings for mimetypes andy
2018-06-13 2:01 ` [PATCH 02/11] Add source page andy
2018-06-13 2:01 ` [PATCH 03/11] Parse render filters from the config andy
2018-06-13 2:01 ` [PATCH 04/11] ui-tree: split out buffer printing andy
2018-06-13 2:01 ` [PATCH 05/11] ui-tree: use render fileters to display content andy
2018-06-16 14:26 ` john
2018-06-16 23:16 ` andy
2018-06-13 2:02 ` [PATCH 06/11] ui-tree: free read_sha1_file() buffer after use andy
2018-06-16 14:24 ` john
2018-06-13 2:02 ` [PATCH 07/11] ui-blame: " andy
2018-06-16 14:23 ` john
2018-06-16 23:17 ` andy
2018-06-13 2:02 ` [PATCH 08/11] ui-tree: print_object: add is_inline param andy
2018-06-16 14:38 ` john
2018-06-13 2:02 ` [PATCH 09/11] ui-tree: ls_tail: add walk table param andy
2018-06-16 14:38 ` john
2018-06-13 2:02 ` [PATCH 10/11] config: add tree-readme list andy
2018-06-16 14:44 ` john
2018-06-13 2:02 ` [PATCH 11/11] ui-tree: render any matching README file in tree view andy
2018-06-16 14:58 ` john
2018-06-14 3:47 ` [PATCH 00/11] Render READMEs inline " andy
2018-06-16 14:17 ` john
2018-06-19 9:01 ` [PATCH v3 00/17] " andy
2018-06-19 9:01 ` [PATCH v3 01/17] manpage: fix sorting order andy
2018-06-19 21:35 ` john [this message]
2018-06-19 9:01 ` [PATCH v3 02/17] blame: css: make blame highlight div absolute and at parent top andy
2018-06-19 9:01 ` [PATCH v3 03/17] Use string list strdup_strings for mimetypes andy
2018-06-19 9:01 ` [PATCH v3 04/17] Add source page andy
2018-06-19 9:01 ` [PATCH v3 05/17] Parse render filters from the config andy
2018-06-19 21:37 ` john
2018-06-19 9:01 ` [PATCH v3 06/17] ui-tree: split out buffer printing andy
2018-06-19 9:02 ` [PATCH v3 07/17] ui-tree: use render filters to display content andy
2018-06-19 9:02 ` [PATCH v3 08/17] ui-blame: free read_sha1_file() buffer after use andy
2018-06-19 21:46 ` john
2018-06-19 9:02 ` [PATCH v3 09/17] ui-tree: ls_tail: add walk table param andy
2018-06-19 9:02 ` [PATCH v3 10/17] config: add global inline-readme list andy
2018-06-19 9:02 ` [PATCH v3 11/17] config: add repo " andy
2018-06-19 9:02 ` [PATCH v3 12/17] ui-tree: render any matching README file in tree view andy
2018-06-19 21:49 ` john
2018-06-20 0:00 ` andy
2018-06-19 9:02 ` [PATCH v3 13/17] md2html: add asset mapping andy
2018-06-19 9:02 ` [PATCH v3 14/17] md2html-add-asset-postfix-arg andy
2018-06-19 9:02 ` [PATCH v3 15/17] ui-shared: deduplicate some code in repolink andy
2018-06-19 21:48 ` john
2018-06-19 9:02 ` [PATCH v3 16/17] ui-shared: add helper for generating non-urlencoded links andy
2018-06-19 21:55 ` john
2018-06-20 0:07 ` andy
2018-06-19 9:02 ` [PATCH v3 17/17] render: adapt for providing extra filter args for plain andy
2018-06-19 21:56 ` john
2018-06-20 10:11 ` [PATCH v4 00/16] Render READMEs inline in tree view andy
2018-06-20 10:12 ` [PATCH v4 01/16] manpage: fix sorting order andy
2018-06-27 17:27 ` Jason
2018-06-20 10:12 ` [PATCH v4 02/16] Use string list strdup_strings for mimetypes andy
2018-06-27 17:28 ` Jason
2018-06-20 10:12 ` [PATCH v4 03/16] Add source page andy
2018-06-20 10:12 ` [PATCH v4 04/16] Parse render filters from the config andy
2018-06-20 10:12 ` [PATCH v4 05/16] ui-tree: split out buffer printing andy
2018-06-20 10:12 ` [PATCH v4 06/16] ui-tree: use render filters to display content andy
2018-06-20 10:12 ` [PATCH v4 07/16] ui-tree: ls_tail: add walk table param andy
2018-06-20 10:12 ` [PATCH v4 08/16] config: add global inline-readme list andy
2018-06-20 10:12 ` [PATCH v4 09/16] config: add repo " andy
2018-06-20 10:12 ` [PATCH v4 10/16] ui-tree: render any matching README file in tree view andy
2018-06-20 10:12 ` [PATCH v4 11/16] md2html: add asset mapping andy
2018-06-27 17:32 ` Jason
2018-06-27 20:00 ` john
2018-06-20 10:12 ` [PATCH v4 12/16] md2html: add asset postfix arg andy
2018-06-20 10:13 ` [PATCH v4 13/16] ui-shared: deduplicate some code in repolink andy
2018-06-27 17:29 ` Jason
2018-06-27 17:50 ` Jason
2018-06-20 10:13 ` [PATCH v4 14/16] ui-shared: add helper for generating non-urlencoded links andy
2018-06-20 10:13 ` [PATCH v4 15/16] render: adapt for providing extra filter args for plain andy
2018-06-20 10:41 ` andy
2018-06-20 10:13 ` [PATCH v4 16/16] md2html: change css name to not conflict with highlight andy
2018-06-27 17:37 ` Jason
2018-06-27 21:58 ` andy
2018-06-28 8:32 ` john
2018-06-23 11:04 ` [PATCH v4 00/16] Render READMEs inline in tree view john
2018-06-23 11:10 ` andy
2018-06-27 17:18 ` Jason
2018-06-27 17:26 ` Fancier Source view [Was: Re: [PATCH v4 00/16] Render READMEs inline in tree view] Jason
2018-06-27 20:05 ` john
2018-06-27 19:51 ` [PATCH v4 00/16] Render READMEs inline in tree view john
2018-06-27 22:48 ` andy
2018-06-27 23:22 ` Jason
2018-06-28 8:28 ` john
2018-07-03 19:34 ` Jason
2018-07-03 19:53 ` john
2018-07-03 19:58 ` Jason
2018-06-27 22:36 ` andy
2018-06-27 22:46 ` Jason
2018-06-27 23:08 ` andy
2018-06-16 14:12 ` Rendering of README.md inline with inner tree view dirs john
2018-06-16 17:35 ` john
2018-06-18 2:22 ` andy
2018-06-18 2:56 ` [PATCH v2 00/15] Render READMEs inline in tree view andy
2018-06-18 2:57 ` [PATCH v2 01/15] manpage: fix sorting order andy
2018-06-18 2:57 ` [PATCH v2 02/15] gcc8.1: fix strncat warning andy
2018-07-03 23:45 ` Jason
2018-07-03 23:47 ` andy
2018-07-03 23:50 ` Jason
2018-06-18 2:57 ` [PATCH v2 03/15] Use string list strdup_strings for mimetypes andy
2018-06-18 2:57 ` [PATCH v2 04/15] Add source page andy
2018-06-18 19:08 ` john
2018-06-18 19:27 ` andy
2018-06-18 2:57 ` [PATCH v2 05/15] Parse render filters from the config andy
2018-06-18 2:57 ` [PATCH v2 06/15] ui-tree: split out buffer printing andy
2018-06-18 2:57 ` [PATCH v2 07/15] ui-tree: use render filters to display content andy
2018-06-18 2:57 ` [PATCH v2 08/15] ui-blame: free read_sha1_file() buffer after use andy
2018-06-18 2:58 ` [PATCH v2 09/15] ui-tree: ls_tail: add walk table param andy
2018-06-18 2:58 ` [PATCH v2 10/15] config: add global inline-readme list andy
2018-06-18 19:32 ` john
2018-06-18 2:58 ` [PATCH v2 11/15] config: add repo " andy
2018-06-18 19:30 ` john
2018-06-18 2:58 ` [PATCH v2 12/15] ui-tree: render any matching README file in tree view andy
2018-06-18 19:36 ` john
2018-06-19 1:55 ` andy
2018-06-19 8:31 ` john
2018-06-19 8:38 ` andy
2018-06-18 2:58 ` [PATCH v2 13/15] md2html: add asset mapping andy
2018-06-18 2:58 ` [PATCH v2 14/15] md2html-add-asset-postfix-arg andy
2018-06-18 19:21 ` john
2018-06-19 3:55 ` andy
2018-06-19 8:34 ` john
2018-06-18 2:58 ` [PATCH v2 15/15] render: adapt for providing extra filter args for plain andy
2018-06-18 19:25 ` john
2018-06-19 3:34 ` andy
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20180619213506.GY1922@john.keeping.me.uk \
--to=cgit@lists.zx2c4.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).