[PATCH] D87242: [flang] Add new documentation main page

Richard Barton via Phabricator via llvm-commits llvm-commits at lists.llvm.org
Fri Sep 11 04:43:57 PDT 2020


richard.barton.arm updated this revision to Diff 291186.
richard.barton.arm added a comment.

>> I don't see a difference in the two for style. Both seem to have previous | next | index links in the top (and bottom) bars, as well as the indexsidebar as you point out. The indexsidebar seems to be a standard default from sphinx. LLVM uses a special one in llvm/docs/_templates/indexsidebar.html which does not have the previous/next topic links and instead has the permalinks to other articles.
>
> I was talking about having the Table Of Contents which is in right pane to be in the center of page the way LLVM has.
> Also when `D87226` would be applied, it would remove the TOC and will add other contents there.

Ah, so a TOC in each page itself. Fair point.

Pushing a new version which adds a local toc to each document. I held off for a few of them as it did not seem to make sense to add one there (either doc too short, or just had one section.) The options comparison doc had a duplicat section title, so I fixed that up too.

Also fixed up some old-style title headings that slipped past the last rebase.


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D87242/new/

https://reviews.llvm.org/D87242

Files:
  flang/docs/ArrayComposition.md
  flang/docs/BijectiveInternalNameUniquing.md
  flang/docs/C++17.md
  flang/docs/C++style.md
  flang/docs/Calls.md
  flang/docs/Character.md
  flang/docs/ControlFlowGraph.md
  flang/docs/Directives.md
  flang/docs/Extensions.md
  flang/docs/FortranForCProgrammers.md
  flang/docs/FortranIR.md
  flang/docs/IORuntimeInternals.md
  flang/docs/ImplementingASemanticCheck.md
  flang/docs/Intrinsics.md
  flang/docs/LabelResolution.md
  flang/docs/ModFiles.md
  flang/docs/OpenMP-4.5-grammar.md
  flang/docs/OpenMP-4.5-grammar.txt
  flang/docs/OpenMP-semantics.md
  flang/docs/OptionComparison.md
  flang/docs/Overview.md
  flang/docs/ParserCombinators.md
  flang/docs/Parsing.md
  flang/docs/Preprocessing.md
  flang/docs/PullRequestChecklist.md
  flang/docs/RuntimeDescriptor.md
  flang/docs/Semantics.md
  flang/docs/conf.py
  flang/docs/f2018-grammar.md
  flang/docs/f2018-grammar.txt
  flang/docs/index.md

-------------- next part --------------
A non-text attachment was scrubbed...
Name: D87242.291186.patch
Type: text/x-patch
Size: 54633 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20200911/c50cce22/attachment.bin>


More information about the llvm-commits mailing list