&lt;html&gt;&lt;head&gt;&lt;/head&gt;&lt;body&gt;<div>I'd also expect the commented examples to be in their section. I have just uncommented example lines in the past (in other softwares like SSH) when being first introduced to the software.<br><br>Being a comment, I see no downside on having the comment inside its section, and the upside is potentially less confusion and mistakes.<br><br>My 0.02</div><br><br><div><div>On March 13, 2026 2:17:56 AM GMT+01:00, David Bremner &lt;david@tethera.net&gt; wrote:</div><blockquote>
&lt;pre class="com-fsck-k9__plain-text-message-pre"&gt;<div>Marc Haber &lt;mh+debian-bugs@zugschlus.de&gt; writes:<br><br></div><blockquote><div><br> I would find it more intuitive if it was formatted like:<br><br> [database]<br> path=/home/mh/.mail<br><br> [user]<br> # User configuration<br> #<br> # Here is where you can let notmuch know how you would like to be<br> # addressed. Valid settings are<br> #<br> #       name            Your full name.<br> #       primary_email   Your primary email address.<br> #       other_email     A list (separated by ';') of other email addresses<br> #                       at which you receive email.<br> #<br> # Notmuch will use the various email addresses configured here when<br> # formatting replies. It will avoid including your own addresses in the<br> # recipient list of replies, and will set the From address based on the<br> # address to which the original email was addressed.<br> #<br> primary_email=---<br><br></div></blockquote><div><br>Your version looks OK to me, but honestly I never look at this file, so<br>let's see if anyone else has opinions. The other question is how much<br>control we have over the output. We're using `g_key_file_set_comment`,<br>so this might be a glib feature request.<br><br>d&lt;hr&gt;notmuch mailing list -- notmuch@notmuchmail.org<br>To unsubscribe send an email to notmuch-leave@notmuchmail.org<br></div>&lt;/pre&gt;</blockquote></div>&lt;/body&gt;&lt;/html&gt;