Thread: developer FAQ

developer FAQ

From
Alvaro Herrera
Date:
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>

Re: developer FAQ

From
Heikki Linnakangas
Date:
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

Re: developer FAQ

From
Heikki Linnakangas
Date:
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

Re: developer FAQ

From
Alvaro Herrera
Date:
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

Re: developer FAQ

From
Magnus Hagander
Date:
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/

Re: developer FAQ

From
Alvaro Herrera
Date:
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

Re: developer FAQ

From
Heikki Linnakangas
Date:
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

Re: developer FAQ

From
Magnus Hagander
Date:
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/