Thread: PGDN source browser
<div class="Section1"><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">Dear all,</span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial"> </span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">The PostgreSQL Developer Network’s Source Browser (beta1) is ready.</span></font><p class="MsoNormal"><fontface="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">If you got the time to check it for a moment, please do not hesitate to send your opinion.</span></font><pclass="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial"> </span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">Regards,</span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">Gevik</span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial"> </span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial">PGDN can be found at <a href="http://www.truesoftware.net/pgdn/">http://www.truesoftware.net/pgdn/</a></span></font><p class="MsoNormal"><font face="Arial"size="2"><span style="font-size:10.0pt; font-family:Arial"> </span></font><p class="MsoNormal"><font face="Arial" size="2"><span style="font-size:10.0pt; font-family:Arial"> </span></font></div>
On 04/06/2005 22:59:19, Gevik babakhani wrote: > Dear all, > > The PostgreSQL Developer Network's Source Browser (beta1) is ready. > > If you got the time to check it for a moment, please do not hesitate to send Firstly, good that you're asking for comments (I assume as an attempt to work with people), but starting an entirley seperatre "developer network" seems rather like reinventing the wheel. Why not invest your time in extending the existing rersources, rather than starting from scratch? Other than saving me from downloading the source (which I keep around anyway, mostly for ease of grepping for things the documentation cant be expected to cover), I see no advantage to using this in it's current form. To me, the point of a source browsing system is that it provides information which a directory structure can't provide. Off the top of my head: * CVS head. Without this, it's always going to be irrelevant to developers who commit to postgresql itself. * CVS history. If you're targeting this at developers, I'd think this is important. * Referencing between function calls and definitions (with ctags, perhaps. Doxygen-style browsers do this.) To me, this isthe single only advantage of presenting source code in HTML: ease of navigation by hyperlinks. Apart from that, web pagesare pretty inconvenient (to me, at least). * Is a tree really appropiate? To compare two files (which is something I might want to use this for), that'd require a lotof scrolling to see where I am in the structure. * diff. Meanwhile, some aesthetic things which spring to mind: The syntax hilighting is confusing for non-.c files; quite a few are parsed incorrectly around comments, and hilighting applied to strange things in plain-text files. There is extreneous whitespace in the <pre> at the top by the line numbers' gutters. There's a off-by-one error in your loop to pad out the numbers: an extra space appears every power of 10. The "number of views" is irrelevant, as is the "...Source Browser" title on each page, which is unneccessary. Hope that helps, -- Tom
Gevik,
I like your idea. I have already checked it out. Its treeview is really like MSDN's.
Some comments, ideas:
- it would be better if the treeview was ordered by name
- the current item in the treeview could be highlighted
- the gutter should have a constant width
- it would be pleasent if there were links to functions in a given C file. I know this is not that simple, though. It would be good for people not yet familiar with the code
These come to my mind after some minutes of browsing fe-connect.c.
I would visit this site often.
Cheers,
Otto
----- Original Message -----From: Gevik babakhaniSent: Saturday, June 04, 2005 10:59 PMSubject: [HACKERS] PGDN source browserDear all,
The PostgreSQL Developer Networks Source Browser (beta1) is ready.
If you got the time to check it for a moment, please do not hesitate to send your opinion.
Regards,
Gevik
PGDN can be found at http://www.truesoftware.net/pgdn/
Gevik, You still didn't answer my question as to why you're reinventing the wheel. Why not just work on updating techdocs instead? -Jonah Tom Flavel wrote: >On 04/06/2005 22:59:19, Gevik babakhani wrote: > > >>Dear all, >> >>The PostgreSQL Developer Network's Source Browser (beta1) is ready. >> >>If you got the time to check it for a moment, please do not hesitate to send >> >> > >Firstly, good that you're asking for comments (I assume as an attempt to >work with people), but starting an entirley seperatre "developer network" >seems rather like reinventing the wheel. Why not invest your time in >extending the existing rersources, rather than starting from scratch? > > >Other than saving me from downloading the source (which I keep around >anyway, mostly for ease of grepping for things the documentation cant be >expected to cover), I see no advantage to using this in it's current >form. > >To me, the point of a source browsing system is that it provides >information which a directory structure can't provide. Off the top of my >head: > >* CVS head. Without this, it's always going to be irrelevant to > developers who commit to postgresql itself. >* CVS history. If you're targeting this at developers, I'd think this is > important. >* Referencing between function calls and definitions (with ctags, > perhaps. Doxygen-style browsers do this.) To me, this is the single > only advantage of presenting source code in HTML: ease of navigation > by hyperlinks. Apart from that, web pages are pretty inconvenient (to > me, at least). >* Is a tree really appropiate? To compare two files (which is something > I might want to use this for), that'd require a lot of scrolling to > see where I am in the structure. >* diff. > > >Meanwhile, some aesthetic things which spring to mind: > >The syntax hilighting is confusing for non-.c files; quite a few are >parsed incorrectly around comments, and hilighting applied to strange >things in plain-text files. > >There is extreneous whitespace in the <pre> at the top by the line >numbers' gutters. There's a off-by-one error in your loop to pad out the >numbers: an extra space appears every power of 10. > >The "number of views" is irrelevant, as is the "...Source Browser" title >on each page, which is unneccessary. > >Hope that helps, > > >
Regarding to update the techdocs and not reinveting the wheel, I am having a mailng with Robert Treat of (webmaster pg) in order to see what can be done.. any help is welcome... :) Regards, Gevik. -----Original Message----- From: Jonah H. Harris [mailto:jharris@tvi.edu] Sent: Monday, June 06, 2005 4:50 PM To: Tom Flavel Cc: Gevik babakhani; pgsql-hackers@postgresql.org Subject: Re: [HACKERS] PGDN source browser Gevik, You still didn't answer my question as to why you're reinventing the wheel. Why not just work on updating techdocs instead? -Jonah Tom Flavel wrote: >On 04/06/2005 22:59:19, Gevik babakhani wrote: > > >>Dear all, >> >>The PostgreSQL Developer Network's Source Browser (beta1) is ready. >> >>If you got the time to check it for a moment, please do not hesitate to send >> >> > >Firstly, good that you're asking for comments (I assume as an attempt to >work with people), but starting an entirley seperatre "developer network" >seems rather like reinventing the wheel. Why not invest your time in >extending the existing rersources, rather than starting from scratch? > > >Other than saving me from downloading the source (which I keep around >anyway, mostly for ease of grepping for things the documentation cant be >expected to cover), I see no advantage to using this in it's current >form. > >To me, the point of a source browsing system is that it provides >information which a directory structure can't provide. Off the top of my >head: > >* CVS head. Without this, it's always going to be irrelevant to > developers who commit to postgresql itself. >* CVS history. If you're targeting this at developers, I'd think this is > important. >* Referencing between function calls and definitions (with ctags, > perhaps. Doxygen-style browsers do this.) To me, this is the single > only advantage of presenting source code in HTML: ease of navigation > by hyperlinks. Apart from that, web pages are pretty inconvenient (to > me, at least). >* Is a tree really appropiate? To compare two files (which is something > I might want to use this for), that'd require a lot of scrolling to > see where I am in the structure. >* diff. > > >Meanwhile, some aesthetic things which spring to mind: > >The syntax hilighting is confusing for non-.c files; quite a few are >parsed incorrectly around comments, and hilighting applied to strange >things in plain-text files. > >There is extreneous whitespace in the <pre> at the top by the line >numbers' gutters. There's a off-by-one error in your loop to pad out the >numbers: an extra space appears every power of 10. > >The "number of views" is irrelevant, as is the "...Source Browser" title >on each page, which is unneccessary. > >Hope that helps, > > >
Thanks! Gevik babakhani wrote: >Regarding to update the techdocs and not reinveting the wheel, I am having a >mailng with Robert Treat of (webmaster pg) in order to see what can be >done.. any help is welcome... :) > >Regards, >Gevik. > > >-----Original Message----- >From: Jonah H. Harris [mailto:jharris@tvi.edu] >Sent: Monday, June 06, 2005 4:50 PM >To: Tom Flavel >Cc: Gevik babakhani; pgsql-hackers@postgresql.org >Subject: Re: [HACKERS] PGDN source browser > >Gevik, > >You still didn't answer my question as to why you're reinventing the >wheel. Why not just work on updating techdocs instead? > >-Jonah > > >Tom Flavel wrote: > > > >>On 04/06/2005 22:59:19, Gevik babakhani wrote: >> >> >> >> >>>Dear all, >>> >>>The PostgreSQL Developer Network's Source Browser (beta1) is ready. >>> >>>If you got the time to check it for a moment, please do not hesitate to >>> >>> >send > > >>> >>> >>> >>> >>Firstly, good that you're asking for comments (I assume as an attempt to >>work with people), but starting an entirley seperatre "developer network" >>seems rather like reinventing the wheel. Why not invest your time in >>extending the existing rersources, rather than starting from scratch? >> >> >>Other than saving me from downloading the source (which I keep around >>anyway, mostly for ease of grepping for things the documentation cant be >>expected to cover), I see no advantage to using this in it's current >>form. >> >>To me, the point of a source browsing system is that it provides >>information which a directory structure can't provide. Off the top of my >>head: >> >>* CVS head. Without this, it's always going to be irrelevant to >> developers who commit to postgresql itself. >>* CVS history. If you're targeting this at developers, I'd think this is >> important. >>* Referencing between function calls and definitions (with ctags, >> perhaps. Doxygen-style browsers do this.) To me, this is the single >> only advantage of presenting source code in HTML: ease of navigation >> by hyperlinks. Apart from that, web pages are pretty inconvenient (to >> me, at least). >>* Is a tree really appropiate? To compare two files (which is something >> I might want to use this for), that'd require a lot of scrolling to >> see where I am in the structure. >>* diff. >> >> >>Meanwhile, some aesthetic things which spring to mind: >> >>The syntax hilighting is confusing for non-.c files; quite a few are >>parsed incorrectly around comments, and hilighting applied to strange >>things in plain-text files. >> >>There is extreneous whitespace in the <pre> at the top by the line >>numbers' gutters. There's a off-by-one error in your loop to pad out the >>numbers: an extra space appears every power of 10. >> >>The "number of views" is irrelevant, as is the "...Source Browser" title >>on each page, which is unneccessary. >> >>Hope that helps, >> >> >> >> >> > > > >
Am Samstag, den 04.06.2005, 22:59 +0200 schrieb Gevik babakhani: > Dear all, > > > > The PostgreSQL Developer Network’s Source Browser (beta1) is ready. > > If you got the time to check it for a moment, please do not hesitate > to send your opinion. Hm. wouldn't an install of trac/postgres (http://trac.edgewall.com ) do much better w/ regard to syntax highliting, diff, ... Still someone would have to adapt the templates to the postgres.org design.