Worst Phobos documentation evar!

[H. S. Teoh via Digitalmars-d]

On Tue, Dec 30, 2014 at 12:42:11PM -0800, Andrei Alexandrescu via Digitalmars-d wrote:
> On 12/30/14 12:31 PM, H. S. Teoh via Digitalmars-d wrote:
> >On Tue, Dec 30, 2014 at 11:36:16AM -0800, Andrei Alexandrescu via Digitalmars-d wrote:
> >>On 12/30/14 10:10 AM, H. S. Teoh via Digitalmars-d wrote:
> >>>Using blank lines to separate paragraphs would be fine,*if*  ddoc
> >>>processes them internally and wraps paragraphs in $(P...)
> >>>automatically instead of inserting $(BLANKLINE). However, currently
> >>>it doesn't. And I am loathe to change this because the PR will
> >>>inevitably get rejected, since it will break every ddoc macro set
> >>>that relies on $(BLANKLINE).
> >>
> >>I'd pull it, and I think it can work alongside BLANKLINE. -- Andrei
> >
> >How would we make it work alongside BLANKLINE? Define $(P ...) as
> >$(BLANKLINE)$0 ? I'm not sure it will actually be equivalent, though,
> >and might cause some problems with existing ddoc macro sets.
> >
> >Or are you saying emit *both* BLANKLINE and P, and the user simply sets
> >one of them to be a no-op?
> 
> The latter. Continue emitting BLANKLINE but set it to nothing. -- Andrei

OK, I'll see if I can whip up a PR for this sometime this week or next
week. In the meantime, for reference, here's the ER for this issue:

	https://issues.dlang.org/show_bug.cgi?id=9731


T

-- 
Without outlines, life would be pointless.