pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedChanging the HTML file extension
8+ messages / 5 participants
[nested] [flat]
* Changing the HTML file extension
@ 2001-02-11 22:34 Peter Eisentraut <peter_e@gmx.net>
2001-02-11 22:48 ` Re: Changing the HTML file extension Bruce Momjian <pgman@candle.pha.pa.us>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
0 siblings, 2 replies; 8+ messages in thread
From: Peter Eisentraut @ 2001-02-11 22:34 UTC (permalink / raw)
To: pgsql-docs
Since I'm writing a custom stylesheet for the docs anyway, we could change
the extension of the HTML files from .htm to .html. This will probably
break a lot of bookmarks, so I thought I'd ask. OTOH, "deep" bookmarks
into the current docs may become obsolete for a variety of other reasons
anyway.
--
Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
@ 2001-02-11 22:48 ` Bruce Momjian <pgman@candle.pha.pa.us>
1 sibling, 0 replies; 8+ messages in thread
From: Bruce Momjian @ 2001-02-11 22:48 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
Agreed. *.htm is an old DOS-ism.
> Since I'm writing a custom stylesheet for the docs anyway, we could change
> the extension of the HTML files from .htm to .html. This will probably
> break a lot of bookmarks, so I thought I'd ask. OTOH, "deep" bookmarks
> into the current docs may become obsolete for a variety of other reasons
> anyway.
>
> --
> Peter Eisentraut peter_e@gmx.net http://yi.org/peter-e/
>
>
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
@ 2001-02-11 23:43 ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:06 ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
2001-02-12 00:10 ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
1 sibling, 2 replies; 8+ messages in thread
From: Vince Vielhaber @ 2001-02-11 23:43 UTC (permalink / raw)
To: Peter Eisentraut <peter_e@gmx.net>; +Cc: pgsql-docs
On Sun, 11 Feb 2001, Peter Eisentraut wrote:
> Since I'm writing a custom stylesheet for the docs anyway, we could change
> the extension of the HTML files from .htm to .html. This will probably
> break a lot of bookmarks, so I thought I'd ask. OTOH, "deep" bookmarks
> into the current docs may become obsolete for a variety of other reasons
> anyway.
Any name changes will affect:
1) FAQ pointers into the docs
2) Web page pointers into the docs
3) Bookmarks
4) Search engine tables
If this is done, the search tables will need to be flushed of old links.
Marc was trying to do it the other day but I don't know how successful
he was on clearing out /docs. /devel-corner/docs will also have to be
done if he was successful. From a conversation I had with Peter yesterday
I agree that it's probably a bad idea to even allow /devel-corner/docs
into the search engine's tables - besides the fact that they change alot
between versions and old ones don't seem to flush.
FAQ pointers should also never point inside development docs (or any
docs for all that matter if they stand a chance of changing at all).
Bookmarks. Many users will bookmark parts of the docs. While it's not
a good idea to bookmark development docs it's still done. I don't think
there's alot we can do about that.
Web pages that point inside the docs. We have some web pages that have
been done and are maintained by folks other than me. Those folks will
need to make sure none of theirs point inside the devel docs. The home
page points to the devel docs index - I can repoint things when necessary
but that probably won't happen till sometime mid next week.
Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 00:06 ` The Hermit Hacker <scrappy@hub.org>
1 sibling, 0 replies; 8+ messages in thread
From: The Hermit Hacker @ 2001-02-12 00:06 UTC (permalink / raw)
To: Vince Vielhaber <vev@michvhf.com>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
All good points ... is there a *valid* reason why we'd switch from .htm to
.html? Like is .htm breaking anything? if not, it should be left as is
...
On Sun, 11 Feb 2001, Vince Vielhaber wrote:
> On Sun, 11 Feb 2001, Peter Eisentraut wrote:
>
> > Since I'm writing a custom stylesheet for the docs anyway, we could change
> > the extension of the HTML files from .htm to .html. This will probably
> > break a lot of bookmarks, so I thought I'd ask. OTOH, "deep" bookmarks
> > into the current docs may become obsolete for a variety of other reasons
> > anyway.
>
> Any name changes will affect:
>
> 1) FAQ pointers into the docs
> 2) Web page pointers into the docs
> 3) Bookmarks
> 4) Search engine tables
>
> If this is done, the search tables will need to be flushed of old links.
> Marc was trying to do it the other day but I don't know how successful
> he was on clearing out /docs. /devel-corner/docs will also have to be
> done if he was successful. From a conversation I had with Peter yesterday
> I agree that it's probably a bad idea to even allow /devel-corner/docs
> into the search engine's tables - besides the fact that they change alot
> between versions and old ones don't seem to flush.
>
> FAQ pointers should also never point inside development docs (or any
> docs for all that matter if they stand a chance of changing at all).
>
> Bookmarks. Many users will bookmark parts of the docs. While it's not
> a good idea to bookmark development docs it's still done. I don't think
> there's alot we can do about that.
>
> Web pages that point inside the docs. We have some web pages that have
> been done and are maintained by folks other than me. Those folks will
> need to make sure none of theirs point inside the devel docs. The home
> page points to the devel docs index - I can repoint things when necessary
> but that probably won't happen till sometime mid next week.
>
> Vince.
> --
> ==========================================================================
> Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
> 128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
> Online Campground Directory http://www.camping-usa.com
> Online Giftshop Superstore http://www.cloudninegifts.com
> ==========================================================================
>
>
>
>
Marc G. Fournier ICQ#7615664 IRC Nick: Scrappy
Systems Administrator @ hub.org
primary: scrappy@hub.org secondary: scrappy@{freebsd|postgresql}.org
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 00:10 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-02-12 00:21 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:33 ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
1 sibling, 2 replies; 8+ messages in thread
From: Tom Lane @ 2001-02-12 00:10 UTC (permalink / raw)
To: Vince Vielhaber <vev@michvhf.com>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
Vince Vielhaber <vev@michvhf.com> writes:
> [ a long list of places that might have links to documentation pages ]
I think this discussion is largely pointless. We have already made a
substantial number of changes in the filenames of various doc pages
since 7.0 (for instance, there aren't numbers in most of 'em anymore),
and I didn't hear anyone objecting. Asking that bookmarks not break is
a little late at this point.
I'm for changing to .html, FWIW.
regards, tom lane
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:10 ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
@ 2001-02-12 00:21 ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 01:01 ` Re: Changing the HTML file extension The Hermit Hacker <scrappy@hub.org>
1 sibling, 1 reply; 8+ messages in thread
From: Vince Vielhaber @ 2001-02-12 00:21 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
On Sun, 11 Feb 2001, Tom Lane wrote:
> Vince Vielhaber <vev@michvhf.com> writes:
> > [ a long list of places that might have links to documentation pages ]
>
> I think this discussion is largely pointless. We have already made a
> substantial number of changes in the filenames of various doc pages
> since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> and I didn't hear anyone objecting. Asking that bookmarks not break is
> a little late at this point.
I agreed about the bookmarks but as to the files changing and noone
objecting, I wish I knew you were responsible BEFORE I answered all
the messages about missing links in the FAQs that pointed to number
type filenames, I could have simply forwarded them to you and saved
alot of time. I think I will change the 404 page tho to tell folks
to send a note to the docs list if it's doc related. If something
breaks everyone will know about it alot sooner.
Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev@michvhf.com http://www.pop4.net
128K ISDN from $22.00/mo - 56K Dialup from $16.00/mo at Pop4 Networking
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:10 ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
2001-02-12 00:21 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
@ 2001-02-12 01:01 ` The Hermit Hacker <scrappy@hub.org>
0 siblings, 0 replies; 8+ messages in thread
From: The Hermit Hacker @ 2001-02-12 01:01 UTC (permalink / raw)
To: Vince Vielhaber <vev@michvhf.com>; +Cc: Tom Lane <tgl@sss.pgh.pa.us>; Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
On Sun, 11 Feb 2001, Vince Vielhaber wrote:
> On Sun, 11 Feb 2001, Tom Lane wrote:
>
> > Vince Vielhaber <vev@michvhf.com> writes:
> > > [ a long list of places that might have links to documentation pages ]
> >
> > I think this discussion is largely pointless. We have already made a
> > substantial number of changes in the filenames of various doc pages
> > since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> > and I didn't hear anyone objecting. Asking that bookmarks not break is
> > a little late at this point.
>
> I agreed about the bookmarks but as to the files changing and noone
> objecting, I wish I knew you were responsible BEFORE I answered all
> the messages about missing links in the FAQs that pointed to number
> type filenames, I could have simply forwarded them to you and saved
> alot of time. I think I will change the 404 page tho to tell folks
> to send a note to the docs list if it's doc related. If something
> breaks everyone will know about it alot sooner.
sounds perfectly reasonable to me ... you are on that list too, right? so
it would hit aall pertinent ppl ...
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: Changing the HTML file extension
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 23:43 ` Re: Changing the HTML file extension Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:10 ` Re: Changing the HTML file extension Tom Lane <tgl@sss.pgh.pa.us>
@ 2001-02-12 00:33 ` The Hermit Hacker <scrappy@hub.org>
1 sibling, 0 replies; 8+ messages in thread
From: The Hermit Hacker @ 2001-02-12 00:33 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: Vince Vielhaber <vev@michvhf.com>; Peter Eisentraut <peter_e@gmx.net>; pgsql-docs
On Sun, 11 Feb 2001, Tom Lane wrote:
> Vince Vielhaber <vev@michvhf.com> writes:
> > [ a long list of places that might have links to documentation pages ]
>
> I think this discussion is largely pointless. We have already made a
> substantial number of changes in the filenames of various doc pages
> since 7.0 (for instance, there aren't numbers in most of 'em anymore),
> and I didn't hear anyone objecting. Asking that bookmarks not break is
> a little late at this point.
Damn, I hate it when someone comes up with even better points *sigh*
I'm for changing also ...
^ permalink raw reply [nested|flat] 8+ messages in thread
end of thread, other threads:[~2001-02-12 01:01 UTC | newest]
Thread overview: 8+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2001-02-11 22:34 Changing the HTML file extension Peter Eisentraut <peter_e@gmx.net>
2001-02-11 22:48 ` Bruce Momjian <pgman@candle.pha.pa.us>
2001-02-11 23:43 ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 00:06 ` The Hermit Hacker <scrappy@hub.org>
2001-02-12 00:10 ` Tom Lane <tgl@sss.pgh.pa.us>
2001-02-12 00:21 ` Vince Vielhaber <vev@michvhf.com>
2001-02-12 01:01 ` The Hermit Hacker <scrappy@hub.org>
2001-02-12 00:33 ` The Hermit Hacker <scrappy@hub.org>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox