Subject: Re: Re: r4361 - in trunk/docutils: docs/user/config.txt docutils/core.py docutils/frontend.py
Newsgroups: gmane.text.docutils.devel
Date: 2006-04-01 18:56:10 GMT (2 years, 5 weeks, 5 days, 23 hours and 8 minutes ago)
[Felix Wiemann] > I'm not sure if we want alphabetical ordering. That's the definition of an index. > You only need alphabetical ordering if you want to quickly look up > something whose name you already know; but for that, you'd use your > browsers search function anyway, I guess. To get an overview, you'd > rather need topical ordering. We already have a topical ordering: by component. Perhaps we need another ordering instead of an index. I don't know what that ordering would be though. >>> Is there any reason (besides implementation time) against >>> allowing:: >>> >>> `--title=TITLE <title_>`__ >>> >>> I.e., allowing embedded refnames and not only embedded refuris? >> >> No reason not to add "embedded references" I suppose, except that >> the syntax becomes somewhat unwieldy. Allowing "anonymous embedded >> references" would defeat the purpose. > > Which purpose? > >> So we should only allow named references (i.e. a single >> trailing underscore). > > I'm not sure if I get your point. Obviously, you didn'tTo reiterate: We can add `--title=TITLE <title_>`__, because that would simplify things. I'd call this an "embedded indirect reference". But "anonymous embedded references" (or "embedded anonymous references") would defeat the purpose: `--title=TITLE <title__>`__. IOW, the "embedded" part doesn't generalize to all existing forms of reference. -- David Goodger <http://python.net/~goodger>