[docutils:patches] #95 Multiterm definition items

Günter Milde via Docutils-develop <[email protected]> Sat, 31 Aug 2024 10:45:24 -0000
Newsgroups gmane.text.docutils.devel
Message-ID </p/docutils/patches/95/e95f57dab26d47dc3f8f02cf2fbebbcd22335002.patches@docutils.p.sourceforge.net>
The syntax implemented in the proposed patch has one drawback explained by David Goodger in the original [docutils-users thread](https://sourceforge.net/p/docutils/mailman/docutils-users/thread/[email protected]/):

> Perhaps we could define
definition list items as one term per line, so this input:

    term 1
    term 2
        definition

> would produce this output:

    <definition_list>
        <definition_list_item>
            <term>
                term 1
            <term>
                term 2
            <definition>
                <paragraph>
                    definition

> The current output is:

    <paragraph>
        term 1
        term 2
    <system_message level="3" line="3" source="<stdin>" type="ERROR">
        <paragraph>
            Unexpected indentation.
    <block_quote>
        <paragraph>
            definition

> I think this type of mistake is currently quite common.  For example,
a paragraph followed immediately (no blank line) by an indented bullet
list.  If we make this change to definition lists a lot of those
helpful errors will disappear, and potentially unhelpful definition
lists will take their place.  Will the new behavior seem surprising or
ambiguous?


---

**[patches:#95] Multiterm definition items**

**Status:** open
**Group:** 
**Created:** Tue Jul 31, 2012 08:38 AM UTC by Kirill Smelkov
**Last Updated:** Thu Jun 06, 2024 08:26 PM UTC
**Owner:** nobody


Following discussion on docutils-users about multi-term definition list items \[1,2\],
I'am also posting my patches here, just to make sure they don't get lost.


Thanks,
Kirill

\[1\] https://sourceforge.net/mailarchive/forum.php?thread\_name=F406FAD0-FC0D-425E-B9DB-EC6D959E8371%40tibsnjoan.co.uk&forum\_name=docutils-users
\[2\] http://permalink.gmane.org/gmane.text.docutils.user/6765


---

Sent from sourceforge.net because [email protected] is subscribed to https://sourceforge.net/p/docutils/patches/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/patches/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.