Re: [Docutils-develop] Rationalize tool names

[<po...@or...>]

David Goodger <go...@py...> writes:

> Other unresolved issues are specified here:
> 
> >> <http://article.gmane.org/gmane.text.docutils.devel/133>,
> >
> > +1. I like those names. Let's do it.
> 
> First we have to answer the many questions in that post.  Care to take a
> stab at them?

Not at the moment. :-) But maybe when I have some free time. In the
mean time I've solved my own problem by simply having symlinks in my
personal bin directory that are named in a way that makes sense to me.

> >>> The current mishmash of names is confusing as hell, imo.
> >> 
> >> Other than replacing "publish" with "pseudo", I don't see any improvement to
> >> the "mishmash" either.
> > 
> > Then perhaps you're too close to the situation
> 
> Agreed, and I've said so before.  But because I am so close to the project,
> I have a strong sense of responsibility/ownership and a unique global
> perspective (please excuse the arrogance).  Speaking generally, sometimes a
> proposed change doesn't feel right, but I can't always explain why.  I have
> to trust my instincts.

That's fine. I understand the position you are in.

> > and need to hear from newbies like me
> 
> And I appreciate all feedback.
> 
> > who struggled to figure out what reST was all about
> > and realized that half the complexity was self-imposed.
> 
> Sorry, I don't buy it, at least not without elaboration.  What's so complex
> about "html.py"?  Methinks you're not a typical user -- simultaneously with
> learning and applying the markup, you're delving into the innards of the
> code, which *is* complex, and unavoidably so.  Can you provide specifics
> rather than sweeping negative-sounding generalities?

You're right that I'm probably not exactly a typical user, but in this
specific case I was pretty close to one. I had a text file with reST
markup that I wanted to output as html, xml, pseudo-xml, Bill's
docarticle, and Aahz's OO. That's when it struck me that the tool
names were not ideal, imo. And I didn't know (or forgot, because I did
real through the archives a while back) that the issue had been
discussed before. (I believe this horse is dead, so I'll stop beating
on it.)

-- 
Patrick K. O'Brien
Orbtech      http://www.orbtech.com/web/pobrien
-----------------------------------------------
"Your source for Python programming expertise."
-----------------------------------------------