On Fri, May 18, 2012 at 9:04 AM, Peter Karman <[email protected]> wrote:
> Why are we not considering POD? POD: /** =over * * =item * * POD lists are outrageously verbose. * * =item * * =over * * =item * * For example, a two-item list occupies 12 lines. * * =item * * Nested POD lists provide no visual hint that they are nested via * indentation. * * =back * * =item * * There are other issues, but IMO POD lists are so problematic that * they suffice to rule out the format. * * =back */ Markdown: /** * POD lists are outrageously verbose. * * For example, a two-item list occupies 12 lines. * * Nested POD lists provide no visual hint that they are nested via * indentation. * * There are other issues, but IMO POD lists are so problematic that * they suffice to rule out the format. */ reStructuredText: /** - POD lists are outrageously verbose. * * - For example, a two-item list occupies 12 lines. * - Nested POD lists provide no visual hint that they are nested via * indentation. * * - There are other issues, but IMO POD lists are so problematic that * they suffice to rule out the format. */ Marvin Humphrey
