<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">

<html lang="en">

<head>

<meta content="text/html; charset=US-ASCII" http-equiv="Content-Type">

<title>

GitLab

</title>

<style>img {

max-width: 100%; height: auto;

}

</style>

</head>

<body>

<div class="content">

<div style="">

<p dir="auto">Tim Rühsen <gl-emoji title="hammer and wrench" data-name="tools" data-unicode-version="7.0">🛠</gl-emoji> <a href="https://gitlab.com/rockdaboot" data-user="267665" data-reference-type="user" data-container="body" data-placement="bottom" class="gfm gfm-project_member" title="Tim Rühsen">@rockdaboot</a> wrote

[...]</p>

<blockquote dir="auto">

<p>Do you know of alternatives?</p>

</blockquote>

<p dir="auto">No, I had searched in vain multiple times. I have found myriads of C option parsing libraries, but many are orphaned and none of the ones I looked offered the autogeneration of docs as autogen did. (A typical example is gengetopt: It can produce manpages, but they are very bare-bone, and it is also dead upstream.)</p>

<blockquote dir="auto">

<p>When adding/changing command line options within the C sources, the man pages and texinfo file should automatically be updated.</p>

<p>This MR does it the following way:</p>

<pre class="code highlight js-syntax-highlight plaintext" lang="plaintext" v-pre="true"><code><span id="LC1" class="line" lang="plaintext">build the tool</span>

<span id="LC2" class="line" lang="plaintext">execute the tool with a special option</span>

<span id="LC3" class="line" lang="plaintext">inject the output from the tool into a markdown template</span>

<span id="LC4" class="line" lang="plaintext">use pandoc to generate manpage and texinfo from the resulting markdown file</span></code></pre>

<p>The workflow allows the developer to just work on the C code (adding an array entry and doing the implementation). No manual editing of texinfo, no out-of-sync of implementation and documentation ever again.</p>

</blockquote>

<p dir="auto">That sounds very sensible and similar to the current solution. Thank you! (FWIW I think that moving away from autogen is something that will need to happen at some point, since it is a single-author project and upstream activity is declining.)</p>

<p dir="auto">Regarding markdown to man and/or texinfo converters: The alternatives are rare. ronn needs ruby and only does manpage output. lunamark (lua) might have been a candidate, but it is not even packaged for Debian.</p>

</div>

</div>

<div class="footer" style="margin-top: 10px;">

<p style="font-size: small; color: #777;">

—

<br>

Reply to this email directly or <a href="https://gitlab.com/gnutls/gnutls/issues/775#note_177011656">view it on GitLab</a>.

<br>

You're receiving this email because of your account on gitlab.com.

If you'd like to receive fewer emails, you can

<a href="https://gitlab.com/sent_notifications/f040a29c89ad69fb2efcdb558878d751/unsubscribe">unsubscribe</a>

from this thread or

adjust your notification settings.

<script type="application/ld+json">{"@context":"http://schema.org","@type":"EmailMessage","action":{"@type":"ViewAction","name":"View Issue","url":"https://gitlab.com/gnutls/gnutls/issues/775#note_177011656"}}</script>

</p>

</div>

</body>

</html>