flatpak-docs icon indicating copy to clipboard operation
flatpak-docs copied to clipboard

Command references have duplicated headers

Open TingPing opened this issue 1 year ago • 2 comments

  • https://docs.flatpak.org/en/latest/flatpak-command-reference.html
  • https://docs.flatpak.org/en/latest/flatpak-builder-command-reference.html

These are generated files from the other projects, so we will need to either change the generation or just manually filter out the headers.

TingPing avatar Jan 09 '24 19:01 TingPing

This is not an automated process is it? Do we know how/who creates the files? Any docs?

razzeee avatar Jan 09 '24 20:01 razzeee

It is all manual. If you build flatpak and flatpak-builder with -Ddocbook_docs=enabled and -Ddocs=enabled respectively they will output the HTML file that gets copied here.

The input template is here: https://github.com/flatpak/flatpak/blob/main/doc/flatpak-docs.xml.in

That said we probably don't want to change the template, maybe a simple import script here that strips it would be a reasonable idea.

TingPing avatar Jan 10 '24 02:01 TingPing