<p>In <a href="https://github.com/mlpack/mlpack/pull/723#discussion_r71165957">src/mlpack/core/util/cli_impl.hpp</a>:</p>
<pre style='color:#555'>> @@ -23,16 +23,19 @@ namespace mlpack {
> * @tparam T The type of the parameter.
> * @param identifier The name of the parameter, eg foo in bar/foo.
> * @param description A string description of the parameter.
> - * @param parent The name of the parent of the parameter,
> - * eg bar/foo in bar/foo/buzz.
> - * @param required If required, the program will refuse to run
> - * unless the parameter is specified.
> + * @param parent The name of the parent of the parameter, e.g. bar/foo in
> + * bar/foo/buzz.
> + * @param required If required, the program will refuse to run unless the
> + * parameter is specified.
> + * @param input If true, the parameter is an input parameter (not an output
> + * parameter).
> */
> template<typename T>
> void CLI::Add(const std::string& identifier,
> const std::string& description,
> const std::string& alias,
</pre>
<p>I took a look in <a href="https://github.com/mlpack/mlpack/commit/7a34fe308372263ac661b8c159647ff77013d612" class="commit-link"><tt>7a34fe3</tt></a>; I think that the <code>parent</code> term is totally outdated and should actually be <code>alias</code>, since what is actually being passed there is the short option name (i.e. <code>-i</code> instead of <code>--input_file</code>). Originally the idea was that the command-line interface would support arbitrarily hierarchical parameters, so each parameter needed to have some parent name associated with it. But this idea ended up being trashed, so we only have a single level of parameters for the sake of simplicity. Only these few lines of comments remained.</p>
<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/mlpack/mlpack/pull/723/files/846af8610a10ae624e82a2b50e5cfdc3cec950d2#r71165957">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AJ4bFE7kYddCaGjLocaA7Gw-osCcerPuks5qW5fygaJpZM4JNibO">mute the thread</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/AJ4bFHXUxKZtbm9OdHK1NPehCS33TXukks5qW5fygaJpZM4JNibO.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://github.com/mlpack/mlpack/pull/723/files/846af8610a10ae624e82a2b50e5cfdc3cec950d2#r71165957"></link>
<meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>