@@ -574,32 +574,70 @@ List markup (:duref:`ref <bullet-lists>`) is simple:
574Definition list
574Definition list
575---------------
575---------------
577−.. sidebar:: definition term
577+.. sidebar:: Note ..
579− Note that the term cannot have more than one line of text.
579+ - the term cannot have more than one line of text
581+ - there is **no blank line between term and definition block** // this
582+ distinguishes definition lists (:duref:`ref <definition-lists>`) from block
583+ quotes (:duref:`ref <block-quotes>`).
585+Each definition list (:duref:`ref <definition-lists>`) item contains a term,
586+optional classifiers and a definition. A term is a simple one-line word or
587+phrase. Optional classifiers may follow the term on the same line, each after
588+an inline ' : ' (**space, colon, space**). A definition is a block indented
589+relative to the term, and may contain multiple paragraphs and other body
590+elements. There may be no blank line between a term line and a definition block
591+(*this distinguishes definition lists from block quotes*). Blank lines are
592+required before the first and after the last definition list item, but are
581−Definition lists (:duref:`ref <definition-lists>`) are created as follows:
595+Definition lists are created as follows:
583.. code:: reST
597.. code:: reST
585− term (up to a line of text)
599+ term 1 (up to a line of text)
586− Definition of the term, which must be indented
600+ Definition 1.
602+ See the typo : this line is not a term!
604+ And this is not term's definition. **There is a blank line** in between
605+ the line above and this paragraph. That's why this paragraph is taken as
606+ **block quote** (:duref:`ref <block-quotes>`) and not as term's definition!
609+ Definition 2, paragraph 1.
611+ Definition 2, paragraph 2.
588− and can even consist of multiple paragraphs
613+ term 3 : classifier
590− next term
616+ term 4 : classifier one : classifier two
591− Description.
617+ Definition 4.
593.. admonition:: definition list
619.. admonition:: definition list
594 :class: rst-example
620 :class: rst-example
596− term (up to a line of text)
622+ term 1 (up to a line of text)
597− Definition of the term, which must be indented
623+ Definition 1.
625+ See the typo : this line is not a term!
627+ And this is not term's definition. **There is a blank line** in between
628+ the line above and this paragraph. That's why this paragraph is taken as
629+ **block quote** (:duref:`ref <block-quotes>`) and not as term's definition!
633+ Definition 2, paragraph 1.
635+ Definition 2, paragraph 2.
599− and can even consist of multiple paragraphs
637+ term 3 : classifier
601− next term
640+ term 4 : classifier one : classifier two
605Quoted paragraphs
643Quoted paragraphs