<table><tr><td style="">kfunk added a comment.
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D6477" rel="noreferrer">View Revision</a></tr></table><br /><div><div><blockquote style="border-left: 3px solid #8C98B8;
          color: #6B748C;
          font-style: italic;
          margin: 4px 0 12px 0;
          padding: 8px 12px;
          background-color: #F8F9FC;">
<div style="font-style: normal;
          padding-bottom: 4px;">In <a href="https://phabricator.kde.org/D6477#121350" style="background-color: #e7e7e7;
          border-color: #e7e7e7;
          border-radius: 3px;
          padding: 0 4px;
          font-weight: bold;
          color: black;text-decoration: none;" rel="noreferrer">D6477#121350</a>, <a href="https://phabricator.kde.org/p/rjvbb/" style="
              border-color: #f1f7ff;
              color: #19558d;
              background-color: #f1f7ff;
                border: 1px solid transparent;
                border-radius: 3px;
                font-weight: bold;
                padding: 0 4px;" rel="noreferrer">@rjvbb</a> wrote:</div>
<div style="margin: 0;
          padding: 0;
          border: 0;
          color: rgb(107, 116, 140);"><p>Aleix Pol Gonzalez wrote on 20170703::12:44:35 re: "<a href="https://phabricator.kde.org/D6477" style="background-color: #e7e7e7;
          border-color: #e7e7e7;
          border-radius: 3px;
          padding: 0 4px;
          font-weight: bold;
          color: black;text-decoration: none;" rel="noreferrer">D6477</a>: KDevelop --help: document the possibility to open files at a specific cursor position"</p>

<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><div class="remarkup-code-block" style="margin: 12px 0;" data-code-lang="text" data-sigil="remarkup-code-block"><pre class="remarkup-code" style="font: 11px/15px "Menlo", "Consolas", "Monaco", monospace; padding: 12px; margin: 0; background: rgba(71, 87, 120, 0.08);">Wouldn't it be easier to write `[FILE(:line)(:column)...]`? It feels a bit too verbose to me.</pre></div></blockquote>

<p>My initial idea was <tt style="background: #ebebeb; font-size: 13px;">[FILE[:line[:column]]...]</tt> but that felt a bit too cryptic/illegible to me in practice.<br />
 If the surrounding square brackets indicate the optional nature of <tt style="background: #ebebeb; font-size: 13px;">FILES</tt> we should probably stick to those brackets, and not use another form with the same intention.</p>

<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><div class="remarkup-code-block" style="margin: 12px 0;" data-code-lang="text" data-sigil="remarkup-code-block"><pre class="remarkup-code" style="font: 11px/15px "Menlo", "Consolas", "Monaco", monospace; padding: 12px; margin: 0; background: rgba(71, 87, 120, 0.08);">Also since some time it supports directories that are opened as a project. This should probably be reflected too.</pre></div></blockquote>

<p><tt style="background: #ebebeb; font-size: 13px;">i18n("Files to load, or directories to load as projects"), "[FILE[:line[:column]]...] [DIRECTORY...]"</tt> ?</p></div>
</blockquote>

<p>/me just learned about <a href="http://docopt.org/" class="remarkup-link" target="_blank" rel="noreferrer">http://docopt.org/</a> -- cool -- so what about:</p>

<p><tt style="background: #ebebeb; font-size: 13px;">i18n("Files to load, or directories to load as projects"), "[FILE[:line[:column]] | DIRECTORY]..."</tt>?</p>

<p>I could live with that.</p>

<p>Bonus points for adding two example usages at the bottom of the help text in a new <tt style="background: #ebebeb; font-size: 13px;">Examples</tt> section(?)</p></div></div><br /><div><strong>REPOSITORY</strong><div><div>R32 KDevelop</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D6477" rel="noreferrer">https://phabricator.kde.org/D6477</a></div></div><br /><div><strong>To: </strong>rjvbb, KDevelop, apol<br /><strong>Cc: </strong>kfunk, apol, kdevelop-devel, geetamc, Pilzschaf, akshaydeo, surgenight, arrowdodger<br /></div>