<!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="">
<blockquote dir="auto">
<p>If I understand the approach is to bring libopts functionality into the tools, and use the internal structures to auto-generate part of the documentation based on output provided by the tool itself. Is that correct?</p>
</blockquote>
<p dir="auto">That's correct.</p>
<p dir="auto">So far I don't see any burden. The psk2 implementation is just a test balloon. <code>gengetopts</code> is far less elegant, also needs config files with a certain syntax that nobody can keep in mind. The only 'config file' now is a markdown template (src/psk2tool.md.in). Markdown is so easy to read/write and meanwhile so widespread that it is the format of choice. The option docs come directly from the C file (src/psk2.c), where it belongs - a developer can add / change stuff directly near the implementation without fighting with a just-half-understood config file format (autogen or gengetopts).</p>
<p dir="auto">BTW I couldn't build gengetopts from git on Solaris OpenCSW platform, so it is more of a burden for libidn2 instead of a helper. <em>If</em> I put work in libidn2, removing getgetopts is on top of the list.</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/merge_requests/1012#note_175852355">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/ecc598def36d0754d675e758e4482108/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 Merge request","url":"https://gitlab.com/gnutls/gnutls/merge_requests/1012#note_175852355"}}</script>
</p>
</div>
</body>
</html>