git-ls-tree, git-rev-list, git-rev-parse: add pages

[BeLi4L]

• The page (if new), does not already exist in the repo.
• The page is in the correct platform directory (common/, linux/, etc.)
• The page has 8 or fewer examples.
• The PR title conforms to the recommended templates.
• The page follows the content guidelines.
• The page description includes a link to documentation or a homepage (if applicable).

[zlatanvasovic]

I would change HEAD~3 to HEAD~N and note it shows the situation N commits ago or something like that.

[BeLi4L]

👍

a2c3e61

[zlatanvasovic]

I would rather not put it as {{{HEAD}}~{{N}}. Maybe just HEAD~{{N}}?

/cc @waldyrious what would be the proper syntax here?

[waldyrious]

@BeLi4L maybe wait for a consensus to emerge in these discussions before applying the changes, otherwise you may need to do a lot of back and forth 😅

As for the syntax, I'm afraid we're making things too complex. The syntax for relative references is not something that this page is responsible for introducing. My suggestion is to simply include the 3 in the command description, and use {{HEAD~3}} as the token, rather than generalize with N. WDYT?

[waldyrious]

Or maybe we could bypass this conundrum altogether by using another type of reference, like a tag (e.g. {{v1.2.3}}).

[waldyrious]

@zdroid I'd like to know what you dislike about using a tag, in light of my comments above.

[sbrl]

Isn't the term commit-ish used in the man pages?

[BeLi4L]

Any news on this? I can use commit-ish if you're all OK with that

[zlatanvasovic]

The current version is fine with me. Maybe @sbrl wants to use "commit-ish" instead, both work for me.

[sbrl]

I don't mind. Either work for me.

[tldr-bot]

The build
for this PR failed with the following error(s):

pages.pt_BR/common/ls.md:27 MD047/single-trailing-newline Files should end with a single newline character

Please fix the error(s) and push again.

[sbrl]

Thanks for sticking with the review process, @BeLi4L!