developer FAQ

Started by Alvaro Herreraabout 15 years ago8 messagesdocs
Jump to latest
#1Alvaro Herrera
alvherre@2ndquadrant.com

Hi,

I just noticed that the developer's FAQ has this question with a link to
the anoncvs cvsweb:
http://wiki.postgresql.org/wiki/Developer_FAQ#How_is_the_source_code_organized.3F

The link is
http://anoncvs.postgresql.org/cvsweb.cgi/~checkout~/pgsql/src/tools/backend/index.html
which no longer works.

The equivalent file in Git seems to be this one:
http://git.postgresql.org/gitweb?p=postgresql.git;a=blob;f=src/tools/backend/index.html;hb=HEAD

However, this displays the raw HTML instead of having it be interpreted
by the browser. Anyone knows how to change this?

--
Álvaro Herrera <alvherre@alvh.no-ip.org>

#2Heikki Linnakangas
heikki.linnakangas@enterprisedb.com
In reply to: Alvaro Herrera (#1)
Re: developer FAQ

On 05.04.2011 21:13, Alvaro Herrera wrote:

Hi,

I just noticed that the developer's FAQ has this question with a link to
the anoncvs cvsweb:
http://wiki.postgresql.org/wiki/Developer_FAQ#How_is_the_source_code_organized.3F

The link is
http://anoncvs.postgresql.org/cvsweb.cgi/~checkout~/pgsql/src/tools/backend/index.html
which no longer works.

The equivalent file in Git seems to be this one:
http://git.postgresql.org/gitweb?p=postgresql.git;a=blob;f=src/tools/backend/index.html;hb=HEAD

However, this displays the raw HTML instead of having it be interpreted
by the browser. Anyone knows how to change this?

Oh, rats. I misunderstood your question, and changed the link to what
you posted because it seemed to work for me. It was only after I saved
that I realized what you meant - the link displays the html source, not
properly rendered html.

Googling around for a solution...

--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com

#3Heikki Linnakangas
heikki.linnakangas@enterprisedb.com
In reply to: Heikki Linnakangas (#2)
Re: developer FAQ

On 05.04.2011 21:28, Heikki Linnakangas wrote:

On 05.04.2011 21:13, Alvaro Herrera wrote:

Hi,

I just noticed that the developer's FAQ has this question with a link to
the anoncvs cvsweb:
http://wiki.postgresql.org/wiki/Developer_FAQ#How_is_the_source_code_organized.3F

The link is
http://anoncvs.postgresql.org/cvsweb.cgi/~checkout~/pgsql/src/tools/backend/index.html

which no longer works.

The equivalent file in Git seems to be this one:
http://git.postgresql.org/gitweb?p=postgresql.git;a=blob;f=src/tools/backend/index.html;hb=HEAD

However, this displays the raw HTML instead of having it be interpreted
by the browser. Anyone knows how to change this?

Oh, rats. I misunderstood your question, and changed the link to what
you posted because it seemed to work for me. It was only after I saved
that I realized what you meant - the link displays the html source, not
properly rendered html.

Googling around for a solution...

Hmm, is the /etc/mime.types file missing or somehow strange on that
host? When I do "git instaweb" on my laptop in a clone of the repository
and navigate to that index.html, it renders fine.

However, none of the links work. They contain relative links like
"../../backend/bootstrap", which doesn't work with the more complicated
URL scheme that gitweb uses.

How about we move this page to the wiki? It'd be more likely to get
updated there too.

--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com

#4Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: Heikki Linnakangas (#3)
Re: developer FAQ

Excerpts from Heikki Linnakangas's message of mar abr 05 14:48:56 -0400 2011:

Hmm, is the /etc/mime.types file missing or somehow strange on that
host? When I do "git instaweb" on my laptop in a clone of the repository
and navigate to that index.html, it renders fine.

Possibly ...

However, none of the links work. They contain relative links like
"../../backend/bootstrap", which doesn't work with the more complicated
URL scheme that gitweb uses.

How about we move this page to the wiki? It'd be more likely to get
updated there too.

I think I suggested that years ago when we moved the Developer's faq to
the wiki, and was turned down. It wasn't much of a problem because it
still worked in the source, but now that it doesn't, I agree we should
do just that (assuming it can be made to work there).

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

#5Magnus Hagander
magnus@hagander.net
In reply to: Alvaro Herrera (#4)
Re: developer FAQ

On Tue, Apr 5, 2011 at 21:04, Alvaro Herrera <alvherre@commandprompt.com> wrote:

Excerpts from Heikki Linnakangas's message of mar abr 05 14:48:56 -0400 2011:

Hmm, is the /etc/mime.types file missing or somehow strange on that
host? When I do "git instaweb" on my laptop in a clone of the repository
and navigate to that index.html, it renders fine.

Possibly ...

There is no /etc/mime.types, no.

Is this supposed to be the one from apache? freebsd seems to stick it
in /usr/local/etc/apache22/mime.types - but does gitweb use it
natively somehow?

However, none of the links work. They contain relative links like
"../../backend/bootstrap", which doesn't work with the more complicated
URL scheme that gitweb uses.

How about we move this page to the wiki? It'd be more likely to get
updated there too.

I think I suggested that years ago when we moved the Developer's faq to
the wiki, and was turned down.  It wasn't much of a problem because it
still worked in the source, but now that it doesn't, I agree we should
do just that (assuming it can be made to work there).

I still think it would make a lot of sense to put it on the wiki
instead. Do you recall what the arguments were for not having it
there?

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/

#6Alvaro Herrera
alvherre@2ndquadrant.com
In reply to: Magnus Hagander (#5)
Re: developer FAQ

Excerpts from Magnus Hagander's message of mié abr 06 14:06:32 -0300 2011:

On Tue, Apr 5, 2011 at 21:04, Alvaro Herrera <alvherre@commandprompt.com> wrote:

Excerpts from Heikki Linnakangas's message of mar abr 05 14:48:56 -0400 2011:

I think I suggested that years ago when we moved the Developer's faq to
the wiki, and was turned down.  It wasn't much of a problem because it
still worked in the source, but now that it doesn't, I agree we should
do just that (assuming it can be made to work there).

I still think it would make a lot of sense to put it on the wiki
instead. Do you recall what the arguments were for not having it
there?

Here's the old discussion:
http://archives.postgresql.org/message-id/20080907205212.GE3975%40alvh.no-ip.org

Off to read it ...

--
Álvaro Herrera <alvherre@commandprompt.com>
The PostgreSQL Company - Command Prompt, Inc.
PostgreSQL Replication, Consulting, Custom Development, 24x7 support

#7Heikki Linnakangas
heikki.linnakangas@enterprisedb.com
In reply to: Magnus Hagander (#5)
Re: developer FAQ

On 06.04.2011 18:06, Magnus Hagander wrote:

On Tue, Apr 5, 2011 at 21:04, Alvaro Herrera<alvherre@commandprompt.com> wrote:

Excerpts from Heikki Linnakangas's message of mar abr 05 14:48:56 -0400 2011:

Hmm, is the /etc/mime.types file missing or somehow strange on that
host? When I do "git instaweb" on my laptop in a clone of the repository
and navigate to that index.html, it renders fine.

Possibly ...

There is no /etc/mime.types, no.

Is this supposed to be the one from apache? freebsd seems to stick it
in /usr/local/etc/apache22/mime.types - but does gitweb use it
natively somehow?

Yes, gitweb reads /etc/mime.types. You can also set $mimetypes_file in
the config file to read from another location.

(but as discussed, all the links will be broken even if we get that one
html file to display correctly)

--
Heikki Linnakangas
EnterpriseDB http://www.enterprisedb.com

#8Magnus Hagander
magnus@hagander.net
In reply to: Heikki Linnakangas (#7)
Re: developer FAQ

On Thu, Apr 7, 2011 at 01:12, Heikki Linnakangas
<heikki.linnakangas@enterprisedb.com> wrote:

On 06.04.2011 18:06, Magnus Hagander wrote:

On Tue, Apr 5, 2011 at 21:04, Alvaro Herrera<alvherre@commandprompt.com>
 wrote:

Excerpts from Heikki Linnakangas's message of mar abr 05 14:48:56 -0400
2011:

Hmm, is the /etc/mime.types file missing or somehow strange on that
host? When I do "git instaweb" on my laptop in a clone of the repository
and navigate to that index.html, it renders fine.

Possibly ...

There is no /etc/mime.types, no.

Is this supposed to be the one from apache? freebsd seems to stick it
in /usr/local/etc/apache22/mime.types - but does gitweb use it
natively somehow?

Yes, gitweb reads /etc/mime.types. You can also set $mimetypes_file in the
config file to read from another location.

I added:
our $mimetypes_file = '/usr/local/etc/apache22/mime.types';

but it made no difference at all.

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/