Lists of git subcommands missing on git manpage on git-scm.com

[mhagger]

URL for broken page

https://git-scm.com/docs/git#_high_level_commands_porcelain

Problem

The sections `High-level commands (porcelain)" and "Low-level commands (plumbing)" should contain lists of all git commands (e.g., "Manipulation commands"). But on the webpage cited above, there are no commands listed.

Operating system and browser

Ubuntu 24.04 and Google Chrome Version 134.0.6998.88 (Official Build) (64-bit).

Steps to reproduce

Go to the above link. Observe that there are no big lists of git subcommands.

Other details

N/A.

[mhagger]

Here is an image of what I see:

[dscho]

Seems like a re-occurrence of #1941. I would guess that it is caused by that disruptive .txt -> .adoc rename of the Git project.

[dscho]

Yep. This rename is a gift that keeps on giving.</s>

Here you can see the symptom of the problem:

Documentation/cmds-mainporcelain.adoc could not be resolved for expansion
Documentation/cmds-ancillarymanipulators.adoc could not be resolved for expansion
Documentation/cmds-ancillaryinterrogators.adoc could not be resolved for expansion
Documentation/cmds-foreignscminterface.adoc could not be resolved for expansion
Documentation/cmds-plumbingmanipulators.adoc could not be resolved for expansion
Documentation/cmds-plumbinginterrogators.adoc could not be resolved for expansion
Documentation/cmds-synchingrepositories.adoc could not be resolved for expansion
Documentation/cmds-synchelpers.adoc could not be resolved for expansion
Documentation/cmds-purehelpers.adoc could not be resolved for expansion
Documentation/cmds-guide.adoc could not be resolved for expansion
Documentation/cmds-userinterfaces.adoc could not be resolved for expansion
Documentation/cmds-developerinterfaces.adoc could not be resolved for expansion

And those files indeed do not exist, see e.g. https://github.com/git/git/blob/v2.49.0/Documentation/cmds-mainporcelain.adoc.

The reason is that these files need to be generated, and the stunts git-scm.com needs to perform to generate those needs to be adjusted.

[dscho]

@mhagger do you need more pointers to work on a fix?

[mhagger]

Sorry, I won't have time to work on a fix.

[To1ne]

Here you can see the symptom of the problem:

@dscho It's more complex than that. It's because Documentation/git-config.adoc includes Documentation/config.adoc: , which includes config/mergetool.adoc, which includes {build_dir}/mergetools-merge.adoc. Here {build_dir} isn't expanded correctly and it tries to include Documentation/config/mergetools-diff.adoc instead of Documentation/mergetools-diff.adoc.

I'm working on a fix.

[To1ne]

Derp, the issue of the screenshot is a different one from the one described above.

[To1ne]

Opened #1993