asciidoctor: fix synopsis rendering
#5064
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes git-for-windows#5063. Signed-off-by: Johannes Schindelin <[email protected]>
|
/git-artifacts The |
1 task
|
For comparison:
|
rimrul
approved these changes
Jul 18, 2024
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 18, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
mjcheetham
pushed a commit
to mjcheetham/git
that referenced
this pull request
Jul 18, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes git-for-windows#5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 18, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 18, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 18, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 19, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 19, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
dscho
added a commit
that referenced
this pull request
Jul 22, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 22, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 23, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 23, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 24, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
git-for-windows-ci
pushed a commit
that referenced
this pull request
Jul 24, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
mjcheetham
pushed a commit
to mjcheetham/git
that referenced
this pull request
Jul 24, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes git-for-windows#5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
dscho
added a commit
that referenced
this pull request
Jul 25, 2024
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of `git clone`'s manual page is rendered differently than before; Its parent commit did the same for `git init`. The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this: SYNOPSIS git clone [ --template= <template-directory>] [ -l ] [ -s ] [ --no-hardlinks ] [ -q ] [ [... continuing like this ...] Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the `<code>` sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0. To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the `<code>` sections of the synopsis are no longer each rendered on their own, individual lines. This fixes #5063. Thanks for taking the time to contribute to Git! Those seeking to contribute to the Git for Windows fork should see http://gitforwindows.org/#contribute on how to contribute Windows specific enhancements. If your contribution is for the core Git functions and documentation please be aware that the Git community does not use the github.com issues or pull request mechanism for their contributions. Instead, we use the Git mailing list ([email protected]) for code and documentation submissions, code reviews, and bug reports. The mailing list is plain text only (anything with HTML is sent directly to the spam folder). Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/) to conveniently send your Pull Requests commits to our mailing list. For a single-commit pull request, please *leave the pull request description empty*: your commit message itself should describe your changes. Please read the "guidelines for contributing" linked above!
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Since 76880f0 (doc: git-clone: apply new documentation formatting guidelines, 2024-03-29), the synopsis of
git clone's manual page is rendered differently than before; Its parent commit did the same forgit init.The result looks quite nice. When rendered with AsciiDoc, that is. When rendered using AsciiDoctor, the result is quite unpleasant to my eye, reading something like this:
Even on the Git home page, where AsciiDoctor's default stylesheet is not used, this change results in some unpleasant rendering where not only the font is changed for the
<code>sections of the synopsis, but padding and a different background color make the visual impression quite uneven: compare https://git-scm.com/docs/git-clone/2.45.0 to https://git-scm.com/docs/git-clone/2.44.0.To fix this, let's apply the method recommended by AsciiDoctor in https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-docinfo to partially override AsciiDoctor's default style sheet so that the
<code>sections of the synopsis are no longer each rendered on their own, individual lines.This fixes #5063.
Thanks for taking the time to contribute to Git!
Those seeking to contribute to the Git for Windows fork should see
http://gitforwindows.org/#contribute on how to contribute Windows specific
enhancements.
If your contribution is for the core Git functions and documentation
please be aware that the Git community does not use the github.com issues
or pull request mechanism for their contributions.
Instead, we use the Git mailing list ([email protected]) for code and
documentation submissions, code reviews, and bug reports. The
mailing list is plain text only (anything with HTML is sent directly
to the spam folder).
Nevertheless, you can use GitGitGadget (https://gitgitgadget.github.io/)
to conveniently send your Pull Requests commits to our mailing list.
For a single-commit pull request, please leave the pull request description
empty: your commit message itself should describe your changes.
Please read the "guidelines for contributing" linked above!