D17466: Fix doxygen markdown rendering

2018-12-14 Thread Eli MacKenzie
This revision was automatically updated to reflect the committed changes.
Closed by commit R264:28dca00d2f3a: Fix doxygen markdown rendering (authored by 
argonel).

REPOSITORY
  R264 KApiDox

CHANGES SINCE LAST UPDATE
  https://phabricator.kde.org/D17466?vs=47230=47589

REVISION DETAIL
  https://phabricator.kde.org/D17466

AFFECTED FILES
  docs/metainfo_syntax.md

To: argonel, apol
Cc: apol, kde-frameworks-devel, kde-doc-english, michaelh, ngraham, bruns, 
skadinna


D17466: Fix doxygen markdown rendering

2018-12-10 Thread Eli MacKenzie
argonel added a comment.


  The use of tildes for doxygen code blocks is documented here: 
https://www.stack.nl/~dimitri/doxygen/manual/markdown.html#md_fenced

REPOSITORY
  R264 KApiDox

REVISION DETAIL
  https://phabricator.kde.org/D17466

To: argonel
Cc: apol, kde-frameworks-devel, kde-doc-english, michaelh, ngraham, bruns, 
skadinna


D17466: Fix doxygen markdown rendering

2018-12-09 Thread Eli MacKenzie
argonel created this revision.
Herald added projects: Frameworks, Documentation.
Herald added subscribers: kde-doc-english, kde-frameworks-devel.
argonel requested review of this revision.

REVISION SUMMARY
  Doxygen's parser appears to have trouble with code blocks delimited by
  backticks and lines within the code blocks that end with backticks.
  
  This also fixes an issue where a heading isn't rendered correctly
  unless it has a blank line after it.

TEST PLAN
  built docs locally

REPOSITORY
  R264 KApiDox

BRANCH
  fix_yaml_rendering

REVISION DETAIL
  https://phabricator.kde.org/D17466

AFFECTED FILES
  docs/metainfo_syntax.md

To: argonel
Cc: kde-frameworks-devel, kde-doc-english, michaelh, ngraham, bruns, skadinna


D8296: Use Ctrl+Alt+, as the standard shortcut for "Configure "

2017-10-15 Thread Eli MacKenzie
argonel added a comment.


  Ctrl-Alt-, is way outside of anything I would expect as a common shortcut. 
Did you try Alt-,? I have no idea whether it'd work or not, but the odds of 
having a menu whose name begins with (or even contains) a comma are low.

REPOSITORY
  R237 KConfig

REVISION DETAIL
  https://phabricator.kde.org/D8296

To: ngraham, #frameworks, #vdg
Cc: aacid, argonel, kfunk, marten, graesslin, broulik, #frameworks


D8296: Use Ctrl+, as the standard shortcut for "Configure "

2017-10-15 Thread Eli MacKenzie
argonel added a comment.


  In https://phabricator.kde.org/D8296, @ngraham wrote:
  
  > I chose Ctrl+, because that's the standard shortcut for all (and I do mean 
all) programs in the macOS world--a standard that has started to trickle into 
the Windows world as well, because there was previously no standard there. 
Might as well standardize on what's already a de facto standard elsewhere, to 
avoid throwing away people's muscle memory.
  
  
  The muscle memory for Mac users isn't preserved, as the keystroke there is 
command-, not control, and command physically corresponds to Alt. So this only 
gets us a relatively new Windows shortcut, on top of the legacy CUA system. I 
have no idea whether Windows still follows CUA or not.
  
  In https://phabricator.kde.org/D8296#155573, @kfunk wrote:
  
  > In KDevelop, this is also a really important shortcut for navigating 
through the source. `Ctrl+,` for jumping to definition, `Ctrl+.` for jumping to 
declaration. /me wonders if one really needs a shortcut for configuring 
shortcuts at all.
  
  
  As we're a CUA-derived UI, we already have a keyboard shortcut for Configure 
Shortcuts: Alt-s Alt-h. Same for Configure $app: Alt-s Alt-c
  
  While I do find switching back and forth between Mac and CUA intermittently 
frustrating, we really can't easily implement the same suite of keystrokes as 
Mac because of the Alt combinations being reserved for menus.

REPOSITORY
  R237 KConfig

REVISION DETAIL
  https://phabricator.kde.org/D8296

To: ngraham, #frameworks, #vdg
Cc: argonel, kfunk, marten, graesslin, broulik, #frameworks