[PATCH 00/15] docs: Convert some pages to rST and clean up (part 6)

Peter Krempa posted 15 patches 2 years ago
Failed in applying to current master (apply log)
.gitlab/issue_templates/bug.md |   2 +-
docs/bugs.rst                  |   5 -
docs/contact.rst               |  11 +-
docs/contribute.rst            |  10 +-
docs/drvesx.rst                |   5 +-
docs/formatdomain.rst          | 112 -----
docs/formatsecret.rst          |   8 +-
docs/governance.rst            |   5 -
docs/kbase/tlscerts.rst        |   4 +-
docs/meson.build               |   6 +-
docs/page.xsl                  |   2 +-
docs/remote.html.in            | 297 ------------
docs/remote.rst                | 209 +++++++++
docs/securityprocess.rst       |   4 +-
docs/storage.html.in           | 833 ---------------------------------
docs/storage.rst               | 790 +++++++++++++++++++++++++++++++
docs/uri.html.in               | 507 --------------------
docs/uri.rst                   | 405 ++++++++++++++++
tools/virt-pki-validate.in     |  10 +-
19 files changed, 1431 insertions(+), 1794 deletions(-)
delete mode 100644 docs/remote.html.in
create mode 100644 docs/remote.rst
delete mode 100644 docs/storage.html.in
create mode 100644 docs/storage.rst
delete mode 100644 docs/uri.html.in
create mode 100644 docs/uri.rst
[PATCH 00/15] docs: Convert some pages to rST and clean up (part 6)
Posted by Peter Krempa 2 years ago
After this series only 2 non-generated HTML files remain:
 - index.html.in
 - 404.html.in

It is possible to convert these but the utility of doing so may not be
great for now.

Additionally this series cleans up some long-broken links and removes
unneeded raw HTML passthrough to declare anchors.

Pavel Hrdina (2):
  docs: storage: rename headers to remove duplicate names
  docs: Convert 'storage' page to rst

Peter Krempa (13):
  docs: formatsecret: Correct link to storage volume XML definition
  Correct links to TLS certificate setup page
  docs: Convert 'remote' page to rst
  docs: remote: Remove 'Limitations' paragraph
  docs: Convert 'uri' page to rst
  docs: uri: Remove old 'NULL URI' section
  docs: uri: Consolidate paragraphs on Xen URIs
  docs: uri: Move the 'test' hypervisor under a 'local hypervisors
    heading
  docs: uri: Rewrite section about transport protocols and extra
    parameters
  docs: governance: Remove unused HTML anchors
  docs: contact: Remove HTML anchors and adjust documents using them
  docs: bugs: Remove raw HTML anchor 'quality'
  docs: formatdomain: Remove old unreferenced HTML anchors

 .gitlab/issue_templates/bug.md |   2 +-
 docs/bugs.rst                  |   5 -
 docs/contact.rst               |  11 +-
 docs/contribute.rst            |  10 +-
 docs/drvesx.rst                |   5 +-
 docs/formatdomain.rst          | 112 -----
 docs/formatsecret.rst          |   8 +-
 docs/governance.rst            |   5 -
 docs/kbase/tlscerts.rst        |   4 +-
 docs/meson.build               |   6 +-
 docs/page.xsl                  |   2 +-
 docs/remote.html.in            | 297 ------------
 docs/remote.rst                | 209 +++++++++
 docs/securityprocess.rst       |   4 +-
 docs/storage.html.in           | 833 ---------------------------------
 docs/storage.rst               | 790 +++++++++++++++++++++++++++++++
 docs/uri.html.in               | 507 --------------------
 docs/uri.rst                   | 405 ++++++++++++++++
 tools/virt-pki-validate.in     |  10 +-
 19 files changed, 1431 insertions(+), 1794 deletions(-)
 delete mode 100644 docs/remote.html.in
 create mode 100644 docs/remote.rst
 delete mode 100644 docs/storage.html.in
 create mode 100644 docs/storage.rst
 delete mode 100644 docs/uri.html.in
 create mode 100644 docs/uri.rst

-- 
2.35.1
Re: [PATCH 00/15] docs: Convert some pages to rST and clean up (part 6)
Posted by Michal Prívozník 2 years ago
On 4/22/22 14:23, Peter Krempa wrote:
> After this series only 2 non-generated HTML files remain:
>  - index.html.in
>  - 404.html.in
> 
> It is possible to convert these but the utility of doing so may not be
> great for now.
> 
> Additionally this series cleans up some long-broken links and removes
> unneeded raw HTML passthrough to declare anchors.
> 
> Pavel Hrdina (2):
>   docs: storage: rename headers to remove duplicate names
>   docs: Convert 'storage' page to rst
> 
> Peter Krempa (13):
>   docs: formatsecret: Correct link to storage volume XML definition
>   Correct links to TLS certificate setup page
>   docs: Convert 'remote' page to rst
>   docs: remote: Remove 'Limitations' paragraph
>   docs: Convert 'uri' page to rst
>   docs: uri: Remove old 'NULL URI' section
>   docs: uri: Consolidate paragraphs on Xen URIs
>   docs: uri: Move the 'test' hypervisor under a 'local hypervisors
>     heading
>   docs: uri: Rewrite section about transport protocols and extra
>     parameters
>   docs: governance: Remove unused HTML anchors
>   docs: contact: Remove HTML anchors and adjust documents using them
>   docs: bugs: Remove raw HTML anchor 'quality'
>   docs: formatdomain: Remove old unreferenced HTML anchors
> 
>  .gitlab/issue_templates/bug.md |   2 +-
>  docs/bugs.rst                  |   5 -
>  docs/contact.rst               |  11 +-
>  docs/contribute.rst            |  10 +-
>  docs/drvesx.rst                |   5 +-
>  docs/formatdomain.rst          | 112 -----
>  docs/formatsecret.rst          |   8 +-
>  docs/governance.rst            |   5 -
>  docs/kbase/tlscerts.rst        |   4 +-
>  docs/meson.build               |   6 +-
>  docs/page.xsl                  |   2 +-
>  docs/remote.html.in            | 297 ------------
>  docs/remote.rst                | 209 +++++++++
>  docs/securityprocess.rst       |   4 +-
>  docs/storage.html.in           | 833 ---------------------------------
>  docs/storage.rst               | 790 +++++++++++++++++++++++++++++++
>  docs/uri.html.in               | 507 --------------------
>  docs/uri.rst                   | 405 ++++++++++++++++
>  tools/virt-pki-validate.in     |  10 +-
>  19 files changed, 1431 insertions(+), 1794 deletions(-)
>  delete mode 100644 docs/remote.html.in
>  create mode 100644 docs/remote.rst
>  delete mode 100644 docs/storage.html.in
>  create mode 100644 docs/storage.rst
>  delete mode 100644 docs/uri.html.in
>  create mode 100644 docs/uri.rst
> 

Yeah, I still not quite understand what went wrong, but after I checked
out your branch on gitlab I can give you my:

Reviewed-by: Michal Privoznik <mprivozn@redhat.com>

Thanks,
Michal
Re: [PATCH 00/15] docs: Convert some pages to rST and clean up (part 6)
Posted by Michal Prívozník 2 years ago
On 4/22/22 14:23, Peter Krempa wrote:
> After this series only 2 non-generated HTML files remain:
>  - index.html.in
>  - 404.html.in
> 
> It is possible to convert these but the utility of doing so may not be
> great for now.
> 
> Additionally this series cleans up some long-broken links and removes
> unneeded raw HTML passthrough to declare anchors.
> 
> Pavel Hrdina (2):
>   docs: storage: rename headers to remove duplicate names
>   docs: Convert 'storage' page to rst
> 
> Peter Krempa (13):
>   docs: formatsecret: Correct link to storage volume XML definition
>   Correct links to TLS certificate setup page
>   docs: Convert 'remote' page to rst
>   docs: remote: Remove 'Limitations' paragraph
>   docs: Convert 'uri' page to rst
>   docs: uri: Remove old 'NULL URI' section
>   docs: uri: Consolidate paragraphs on Xen URIs
>   docs: uri: Move the 'test' hypervisor under a 'local hypervisors
>     heading
>   docs: uri: Rewrite section about transport protocols and extra
>     parameters
>   docs: governance: Remove unused HTML anchors
>   docs: contact: Remove HTML anchors and adjust documents using them
>   docs: bugs: Remove raw HTML anchor 'quality'
>   docs: formatdomain: Remove old unreferenced HTML anchors
> 
>  .gitlab/issue_templates/bug.md |   2 +-
>  docs/bugs.rst                  |   5 -
>  docs/contact.rst               |  11 +-
>  docs/contribute.rst            |  10 +-
>  docs/drvesx.rst                |   5 +-
>  docs/formatdomain.rst          | 112 -----
>  docs/formatsecret.rst          |   8 +-
>  docs/governance.rst            |   5 -
>  docs/kbase/tlscerts.rst        |   4 +-
>  docs/meson.build               |   6 +-
>  docs/page.xsl                  |   2 +-
>  docs/remote.html.in            | 297 ------------
>  docs/remote.rst                | 209 +++++++++
>  docs/securityprocess.rst       |   4 +-
>  docs/storage.html.in           | 833 ---------------------------------
>  docs/storage.rst               | 790 +++++++++++++++++++++++++++++++
>  docs/uri.html.in               | 507 --------------------
>  docs/uri.rst                   | 405 ++++++++++++++++
>  tools/virt-pki-validate.in     |  10 +-
>  19 files changed, 1431 insertions(+), 1794 deletions(-)
>  delete mode 100644 docs/remote.html.in
>  create mode 100644 docs/remote.rst
>  delete mode 100644 docs/storage.html.in
>  create mode 100644 docs/storage.rst
>  delete mode 100644 docs/uri.html.in
>  create mode 100644 docs/uri.rst
> 

I'm having troubles applying these cleanly. In fact, patch 08/15 does
not apply at all:

Applying: docs: uri: Remove old 'NULL URI' section
error: patch failed: docs/uri.rst:420
error: docs/uri.rst: patch does not apply
Patch failed at 0008 docs: uri: Remove old 'NULL URI' section

Do these depend on some other yet not merged patches?

Michal