In Doxygen 1.9.7, the URL generation logic changed such that input
files in directories (i.e. /docs/Hooks.md) are published with the
slug `md_docs_2Hooks.html` instead of `md_docs_Hooks.html`.
This was done to improve an edge case where if two conflicting
files existed (e.g. docs_Foo.md and docs/Foo.md) both can now get
their own stable URL in a determimistic way (e.g. as opposed to
a-z sorting and appending _2 only if a conflict exists). But this
made other more common URLs no longer stable. Work around this by
setting an explict permalink for each markdown file.
Ref https://github.com/doxygen/doxygen/issues/10721.
Change-Id: Ifeb03602452c1148bd372555bebac9922c583ac2
There's already a thing called magic words, and this is not it. These
things are called variables. There are many usages of this term in the
source. The term was introduced by Lee in 2002: originally
OutputPage::replaceVariables() contained only this functionality.
I introduced the term "magic word", meaning a localizable keyword.
Localizable keywords are an abstraction not limited to this use case.
"Magic variables" is a neologism, but I suppose it is permissible, since
it disambiguates. Whereas calling a variable a magic word conflates rather
than disambiguates.
Fix terminology in magicword.md and update the examples.
Change-Id: I621c888e3790a145ca9978f6b30ff1a8f685b64c
Use code highlighting where relevant
Fix list syntax in memcached.md to render lists without paragraph breaks
Add a missing period to schema.md
Change-Id: I763cfd479968cedbf952c231283d33b82a0910d6
Markdown format implemented in docs/magicword.md and docs/memcached.md
A section with helpful resources has been added in docs/Introduction.md
Whitespaces removed, Intoduction.md modified
Unnecessary whitespaces have been removed. Helpful resources section has been modified.
Headings fixed, Title changed in magicword.md
Title changed from "magicword.txt" to "Magic Words" in docs/magicword.md.
Some H1 headers changed to H2 in docs/memcached.md and docs/Introduction.md.
An unnecessary sentence removed in docs/Introduction.md.
Change-Id: I5c9e8663c922be4ca5f0eea9d5c2469b1b18281c
Task: T111298
