[MacPorts] #55778: multimarkdown @6.2.3: breaking changes with previous version @4.5

[MacPorts]

#55778: multimarkdown @6.2.3: breaking changes with previous version @4.5
-------------------------+---------------------------
 Reporter:  jlargentaye  |      Owner:
     Type:  defect       |     Status:  new
 Priority:  Normal       |  Milestone:
Component:  ports        |    Version:
 Keywords:               |       Port:  multimarkdown
-------------------------+---------------------------
 The multimarkdown port was updated from 4.5 (hereafter MMD4) straight to
 6.2.3 (hereafter MMD6). This is a breaking change with no backward- or
 forward- compatibility considerations, and for this reason should've been
 a separate sub-port.

 One of multimarkdown's benefits is its ability to generate Latex output
 for PDF generation. To do so, it uses metadata to specify some latex setup
 using entries like

 {{{
 latex input: memoir
 }}}

 However, MMD6 deprecated this directive in favor of the more specific
 `latex leader` and `latex begin` directives, and will simply ignore the
 `latex input` directive. This would be fine if we could just include both,
 but unfortunately MMD4 includes the latex directives verbatim, which LaTex
 will then fail to recognize.

 Thus, it is not possible to have a Latex-producing multimarkdown document
 that works with both MMD4 and MMD6.

 This is somewhat documented in the MMD6 documentation, in the "Latex
 Changes" section of the QuickStart guide:

 https://github.com/fletcher/MultiMarkdown-6/blob/master/QuickStart/QuickStart.txt#L296

 (The "website" for MMD6 is currently broken and mostly empty:
 https://fletcher.github.io/MultiMarkdown-6/ )

 So heads up for the next time: if a project version is "basically a
 complete rewrite  with a new license", it may not be a good idea to use
 the same portname as the older version.

--
Ticket URL: <https://trac.macports.org/ticket/55778>
MacPorts <https://www.macports.org/>
Ports system for macOS