public inbox for docbook-tools-discuss@sourceware.org
 help / color / mirror / Atom feed
* Re: new tools coming and a couple of renamings
  2000-12-27  6:36   ` Sylvan Ravinet
@ 2000-07-21  0:08     ` Sylvan Ravinet
  0 siblings, 0 replies; 11+ messages in thread
From: Sylvan Ravinet @ 2000-07-21  0:08 UTC (permalink / raw)
  To: esr; +Cc: Mark Galassi, Docbook Tools discussion list

Hi folks,

On Fri, 21 Jul 2000 esr@thyrsus.com wrote:

> something to do with databases.  Removing ambiguity is good.  On the
> other hand, it's proper Unix tradition to have short names for a
> reason -- it saves typing for hapless fumble-fingers like me.

bash and tab-completion work well with that kind of pb, imho.
So long or short names, that's all the same for me.

+1

Eagerly waiting fo this new release,

-Sylvan

--
Do, or do not. There's no try. -Yoda
Sylvan Ravinet: http://www.ravinet.com/sylvan/contact

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 new tools coming and a couple of renamings Mark Galassi
@ 2000-12-27  6:36 ` esr
  2000-12-27  6:36   ` Eric Lee Green
                     ` (2 more replies)
  2000-12-27  6:36 ` Bill Brooks
  2000-12-27  6:36 ` Norman Walsh
  2 siblings, 3 replies; 11+ messages in thread
From: esr @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Mark Galassi; +Cc: Docbook Tools discussion list

Mark Galassi <rosalia@galassi.org>:
> So my proposal is to deprecate the db2* names in favor of the
> docbook2* names.  This phase-out would be extremely slow, since
> thousands of build procedures use the db2* scripts now.
> 
> Anyone wanna contribute an opinion?

What?  You want to make me type six whole extra letters for *each* *name*?

:-)

Seriously, I would probably be firm that it ain't worth the hassle if
it weren't for the fact that that "db" prefix looks like it has
something to do with databases.  Removing ambiguity is good.  On the
other hand, it's proper Unix tradition to have short names for a
reason -- it saves typing for hapless fumble-fingers like me.

So I'm just a touch on the negative side of neutral on this one.  We'd
say "-0" in Python-land.
-- 
		<a href=" http://www.tuxedo.org/~esr ">Eric S. Raymond</a>

The only purpose for which power can be rightfully exercised over any
member of a civilized community, against his will, is to prevent harm
to others. His own good, either physical or moral, is not a sufficient
warrant
	-- John Stuart Mill, "On Liberty", 1859

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 new tools coming and a couple of renamings Mark Galassi
  2000-12-27  6:36 ` esr
@ 2000-12-27  6:36 ` Bill Brooks
  2000-12-27  6:36   ` Mark Galassi
  2000-12-27  6:36 ` Norman Walsh
  2 siblings, 1 reply; 11+ messages in thread
From: Bill Brooks @ 2000-12-27  6:36 UTC (permalink / raw)
  To: docbook-tools-discuss

On 20 Jul 2000, Mark Galassi wrote:

> 
> Dear Docbook Tools enthusiasts,
> 
> After a long period of "no innovation", Eric Bischoff and I (Eric did
> most of the work) are about to put out an up-to-date, orthogonal and
> cleaned-up release of the docbook tools.

Is it going to be able to compile from source on something other than
RedHat linux or close cousins?

Bill


^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 ` esr
@ 2000-12-27  6:36   ` Eric Lee Green
  2000-12-27  6:36   ` Jorge Godoy
  2000-12-27  6:36   ` Sylvan Ravinet
  2 siblings, 0 replies; 11+ messages in thread
From: Eric Lee Green @ 2000-12-27  6:36 UTC (permalink / raw)
  To: esr, Mark Galassi; +Cc: Docbook Tools discussion list

On Fri, 21 Jul 2000, esr@thyrsus.com wrote:
> Mark Galassi <rosalia@galassi.org>:
> > So my proposal is to deprecate the db2* names in favor of the
> > docbook2* names.  This phase-out would be extremely slow, since
> > thousands of build procedures use the db2* scripts now.
>
> something to do with databases.  Removing ambiguity is good.  On the
> other hand, it's proper Unix tradition to have short names for a
> reason -- it saves typing for hapless fumble-fingers like me.

'db' is too much like a database name. 'docbook' is too long. How about "docb"?
as in,  "docb2html" etc.? Yeah, it's just 3 characters shorter, but it appears
to be the shortest unambiguous name... clearly says the command has something
to do with docs, and the b is clue enough that it's dealing with docbook. 

Alternately, "doc2html" etc... hmm...  bit ambigous there. Might make me think
it's a generic x-format doc to html translater....

 -- 
Eric Lee Green      There is No Conspiracy
eric@badtux.org     http://www.badtux.org  

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 new tools coming and a couple of renamings Mark Galassi
  2000-12-27  6:36 ` esr
  2000-12-27  6:36 ` Bill Brooks
@ 2000-12-27  6:36 ` Norman Walsh
  2 siblings, 0 replies; 11+ messages in thread
From: Norman Walsh @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Docbook Tools discussion list

/ Mark Galassi <rosalia@galassi.org> was heard to say:
| Anyone wanna contribute an opinion?

+1

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com> | The shoe that fits one person pinches
http://nwalsh.com/            | another; there is no recipe for living
                              | that suits all cases.--Jung

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36   ` Mark Galassi
@ 2000-12-27  6:36     ` Eric Bischoff
  0 siblings, 0 replies; 11+ messages in thread
From: Eric Bischoff @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Docbook Tools discussion list

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 1565 bytes --]

Mark Galassi wrote:
> 
>     Bill> Is it going to be able to compile from source on something
>     Bill> other than RedHat linux or close cousins?
> 
> Indeed it will compile on all sorts of things.  Thanks to Eric's
> cleanup I feel like it's actually worth the effort.
> 
> Our intention is to produce tarballs, and I got your mail as I was
> adding configure.in/Makefile.am files to the docbook-utils package (a
> process known as "autobarfing a package").

Yes, it does compile on a wide range of platforms. It even installs and
works ;-).

What *does not work* is to install the binary RPM on a non-RedHat
cousin.

But if you rebuild the source package on a given platform:

	# rpm -ba SPECS/twiddledoodle.spec

then the generated binary RPM will normally work on that platform. Don't
forget to send the source RPM to the maintainers of this distribution
and to tell them that it worked out - normally they love your doing
their work ;-).

Same for Debian systems, if you repackage the tarball, thanks to Mark's
efforts in the automake/autoconf area.

-- 
 Éric Bischoff   -   mailto:ebisch@cybercable.tm.fr
 __________________________________________________
                                           \^o~_.
     .~.                           ______  /( __ )
     /V\         Toys story         \__  \/  (  V
   //   \\                            \__| (__=v
  /(     )\                        |\___/     )
    ^^-^^                           \_____(  )
     Tux                        Konqui     \__=v
 __________________________________________________

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 ` esr
  2000-12-27  6:36   ` Eric Lee Green
@ 2000-12-27  6:36   ` Jorge Godoy
  2000-12-27  6:36   ` Sylvan Ravinet
  2 siblings, 0 replies; 11+ messages in thread
From: Jorge Godoy @ 2000-12-27  6:36 UTC (permalink / raw)
  To: esr; +Cc: Mark Galassi, Docbook Tools discussion list

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 890 bytes --]

>>>>> "esr" == esr  <esr@thyrsus.com> writes:

    esr> Seriously, I would probably be firm that it ain't worth the
    esr> hassle if it weren't for the fact that that "db" prefix looks
    esr> like it has something to do with databases.  Removing
    esr> ambiguity is good.  On the other hand, it's proper Unix
    esr> tradition to have short names for a reason -- it saves typing
    esr> for hapless fumble-fingers like me.

C'mon Eric!

You can make aliases for these commands. It will only cost you extra
typing once. :-) 

Unix is wonderful in it's resources. Let's not just worry with long
names if it can be solved with extra aliases. 

Another ambiguity that was solved by choosing this name is the
association with IBM's DB2. 


See you,
-- 
Godoy. <godoy@conectiva.com>

Departamento de Publicações       Conectiva S.A.
Publishing Department             Conectiva Inc.

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 ` Bill Brooks
@ 2000-12-27  6:36   ` Mark Galassi
  2000-12-27  6:36     ` Eric Bischoff
  0 siblings, 1 reply; 11+ messages in thread
From: Mark Galassi @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Docbook Tools discussion list

    Bill> Is it going to be able to compile from source on something
    Bill> other than RedHat linux or close cousins?

Indeed it will compile on all sorts of things.  Thanks to Eric's
cleanup I feel like it's actually worth the effort.

Our intention is to produce tarballs, and I got your mail as I was
adding configure.in/Makefile.am files to the docbook-utils package (a
process known as "autobarfing a package").

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: new tools coming and a couple of renamings
  2000-12-27  6:36 ` esr
  2000-12-27  6:36   ` Eric Lee Green
  2000-12-27  6:36   ` Jorge Godoy
@ 2000-12-27  6:36   ` Sylvan Ravinet
  2000-07-21  0:08     ` Sylvan Ravinet
  2 siblings, 1 reply; 11+ messages in thread
From: Sylvan Ravinet @ 2000-12-27  6:36 UTC (permalink / raw)
  To: esr; +Cc: Mark Galassi, Docbook Tools discussion list

Hi folks,

On Fri, 21 Jul 2000 esr@thyrsus.com wrote:

> something to do with databases.  Removing ambiguity is good.  On the
> other hand, it's proper Unix tradition to have short names for a
> reason -- it saves typing for hapless fumble-fingers like me.

bash and tab-completion work well with that kind of pb, imho.
So long or short names, that's all the same for me.

+1

Eagerly waiting fo this new release,

-Sylvan

--
Do, or do not. There's no try. -Yoda
Sylvan Ravinet: http://www.ravinet.com/sylvan/contact

^ permalink raw reply	[flat|nested] 11+ messages in thread

* new tools coming and a couple of renamings
@ 2000-12-27  6:36 Mark Galassi
  2000-12-27  6:36 ` esr
                   ` (2 more replies)
  0 siblings, 3 replies; 11+ messages in thread
From: Mark Galassi @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Docbook Tools discussion list

Dear Docbook Tools enthusiasts,

After a long period of "no innovation", Eric Bischoff and I (Eric did
most of the work) are about to put out an up-to-date, orthogonal and
cleaned-up release of the docbook tools.

More details will come out soon, but meanwhile I need to poll all of
you on one issue:

Some people have been asking us to please change the names db2html,
db2ps, ... into docbook2html, docbook2ps, ....

I like the idea for the following reasons:

1. The db2* names were not really thought out: they were quick handy
   scripts at Cygnus.

2. The letters "db" come up in "debug", "database", "docbook", and who
   knows what else.  "db2html" is particularly dangerous.

3. I'm not usually impressed with abbreviations.  They make things
   hard to remember and don't save that much time.

So my proposal is to deprecate the db2* names in favor of the
docbook2* names.  This phase-out would be extremely slow, since
thousands of build procedures use the db2* scripts now.

Anyone wanna contribute an opinion?

^ permalink raw reply	[flat|nested] 11+ messages in thread

* RE: new tools coming and a couple of renamings
@ 2000-12-27  6:36 Gregory Leblanc
  0 siblings, 0 replies; 11+ messages in thread
From: Gregory Leblanc @ 2000-12-27  6:36 UTC (permalink / raw)
  To: Docbook Tools discussion list

> -----Original Message-----
> From: Mark Galassi [ mailto:rosalia@galassi.org ]
> Sent: Thursday, July 20, 2000 9:55 PM
> To: Docbook Tools discussion list
> Subject: new tools coming and a couple of renamings
> 
> Dear Docbook Tools enthusiasts,
> 
> After a long period of "no innovation", Eric Bischoff and I (Eric did
> most of the work) are about to put out an up-to-date, orthogonal and
> cleaned-up release of the docbook tools.
> 
> More details will come out soon, but meanwhile I need to poll all of
> you on one issue:
> 
> Some people have been asking us to please change the names db2html,
> db2ps, ... into docbook2html, docbook2ps, ....
> 
> I like the idea for the following reasons:
> 
> 1. The db2* names were not really thought out: they were quick handy
>    scripts at Cygnus.
> 
> 2. The letters "db" come up in "debug", "database", "docbook", and who
>    knows what else.  "db2html" is particularly dangerous.
> 
> 3. I'm not usually impressed with abbreviations.  They make things
>    hard to remember and don't save that much time.
> 
> So my proposal is to deprecate the db2* names in favor of the
> docbook2* names.  This phase-out would be extremely slow, since
> thousands of build procedures use the db2* scripts now.
> 
> Anyone wanna contribute an opinion?

I'm all for the name change, as I always think "IBM's premier database (DB2)
converted into html" rather than "DocBook converted into html".  And if
people want to keep the old names, they just edit their .profile and add
some aliases.  Later,
	Grego

^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2000-12-27  6:36 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2000-12-27  6:36 new tools coming and a couple of renamings Mark Galassi
2000-12-27  6:36 ` esr
2000-12-27  6:36   ` Eric Lee Green
2000-12-27  6:36   ` Jorge Godoy
2000-12-27  6:36   ` Sylvan Ravinet
2000-07-21  0:08     ` Sylvan Ravinet
2000-12-27  6:36 ` Bill Brooks
2000-12-27  6:36   ` Mark Galassi
2000-12-27  6:36     ` Eric Bischoff
2000-12-27  6:36 ` Norman Walsh
2000-12-27  6:36 Gregory Leblanc

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).