Re: [DOCS] maintenance diff
On Thursday 13 July 2006 20:58, Joshua D. Drake wrote:
> Hello,
>
> Updated to have stronger wording for vacuuming. Cleaned out some extra
> superlatives. Added a couple of index entries for Routine Maintenance
> and added entry specific to Analyze.
I noticed a number of typos in this...
s/Gbord/Gborg/
s/Gforg/Gforge/
s/including, mailing/including mailing
s/forums and cvs/forums, and cvs,/
s/pgFoundry/PgFoundry/
I think there might be some other issues too... like saying gborg is
deprecated is likely to imply something wrong with the projects there rather
than the site itself.
There were a couple of other minor things I noticed too... Joshua, do you mind
if I make some changes and resubmit this patch?
--
Robert Treat
Build A Brighter LAMP :: Linux Apache {middleware} PostgreSQL
---(end of broadcast)---
TIP 6: explain analyze is your friend
Re: [DOCS] maintenance diff
Robert Treat wrote: On Thursday 13 July 2006 20:58, Joshua D. Drake wrote: Hello, Updated to have stronger wording for vacuuming. Cleaned out some extra superlatives. Added a couple of index entries for Routine Maintenance and added entry specific to Analyze. I noticed a number of typos in this... s/Gbord/Gborg/ s/Gforg/Gforge/ (I am not surprised I did that) s/including, mailing/including mailing s/forums and cvs/forums, and cvs,/ s/pgFoundry/PgFoundry/ I think there might be some other issues too... like saying gborg is deprecated is likely to imply something wrong with the projects there rather than the site itself. I can extend that... The Gborg site is deprecated and all current projects are moving to Gforge. There were a couple of other minor things I noticed too... Joshua, do you mind if I make some changes and resubmit this patch? Let me go back through it first please. Joshua D. Drake -- === The PostgreSQL Company: Command Prompt, Inc. === Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240 Providing the most comprehensive PostgreSQL solutions since 1997 http://www.commandprompt.com/ ---(end of broadcast)--- TIP 6: explain analyze is your friend
[DOCS] Maintenance and External Projects (try 2)
Hello, I did further work on both of these. Cleaned up some stupid spelling and typos (forgot an s here, a y there ;)). The commit log doesn't change from previous except that I added a reference to Sourceforge for external projects, and I specified that there are three required routing maintenance tasks. Please let me know if there is anything else you would like me to do or add. Joshua D. Drake -- === The PostgreSQL Company: Command Prompt, Inc. === Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240 Providing the most comprehensive PostgreSQL solutions since 1997 http://www.commandprompt.com/ *** external-projects.sgml 2006-07-14 09:35:39.820149250 -0700 --- external-projects.sgml.diff 2006-07-14 09:33:42.86484 -0700 *** *** 1,29 ! External Projects PostgreSQL is a complex software project, and managing it is difficult. We have found that many enhancements to PostgreSQL can be more !efficiently developed separately from the core project. Separate !projects can !have their own developer teams, email lists, bug tracking, !and release schedules. While their independence makes !development easier, it makes users' jobs harder. They have to hunt !around looking for database enhancements to meet their needs. !This section describes some of the more popular externally !developed enhancements and guides you on how to find them. !Many PostgreSQL-related projects are !hosted at either !http://gborg.postgresql.org";>GBorg !or http://pgfoundry.org";>pgFoundry. !There are other PostgreSQL-related projects that are hosted !elsewhere, but you will have to do an Internet search to find them. --- 1,34 ! PgFoundry and External Projects PostgreSQL is a complex software project, and managing it is difficult. We have found that many enhancements to PostgreSQL can be more !efficiently developed separately from the core project. ! ! ! !To help our community with the development of their external projects !we have created http://www.pgfoundry.org/";>PgFoundry. !http://www.pgfoundry.org/";>Pgfoundry utlizes the Gforge !software and is similar to SourceForge in its feature set. If you have an !Open Source project that you would like to develop and need project management !resources such as mailing lists, forums and cvs please feel free to create !a new project. !Secondly, many PostgreSQL-related projects are !still hosted at http://gborg.postgresql.org";>GBorg. !Gborg is the original external community developer site. It is currently deprecated !in favor of PgFoundry but still contains many active and relevant projects. There !are other popular PostgreSQL related projects that are !hosted independently as well as at other community sites such as !http://www.sf.net";>SourceForge. You should you google if you !don't find the project you are looking for. *** *** 36,46 PostgreSQL includes very few interfaces with the base distribution. libpq is packaged because !it is the primary C interface and many other !interfaces are built on top of it. ecpg is packaged !because it is tied to the server-side grammar so is very dependent !on the database version. All the other interfaces are independent !projects and must be installed separately. --- 41,50 PostgreSQL includes very few interfaces with the base distribution. libpq is packaged because !it is the primary dependecy of most interfaces available to PostgreSQL. !We also package ecpg is because it is tied to the !server-side grammar. All other interfaces, such as PHP, Perl, Python, !and Ruby are external projects. *** *** 52,115 This is the most common interface for Windows !applications. ! pgjdbc !A JDBC interface. ! Npgsql ! ! !.Net interface for more recent !Windows applications. ! ! ! ! ! ! libpqxx !A newer C++ interface. ! libpq++ !An older C++ interface. ! pgperl !A Perl interface with an API similar !to libpq. ! DBD-Pg !A Perl interface that uses the !DBD-standard API. --- 56,113 This is the most common interface for Windows !applications. http://odbc.postgresql.org/";>Website. ! ODBCng
Re: [DOCS] Maintenance and External Projects (try 2)
"Joshua D. Drake" <[EMAIL PROTECTED]> writes: > Please let me know if there is anything else you would like me to do or add. A round of copy-editing seems indicated, at least. regards, tom lane ---(end of broadcast)--- TIP 4: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] Maintenance and External Projects (try 2)
Tom Lane wrote: "Joshua D. Drake" <[EMAIL PROTECTED]> writes: Please let me know if there is anything else you would like me to do or add. A round of copy-editing seems indicated, at least. Oh, no doubt. I tried to fix as much as I find, including a bunch of stuff already there. However, I do not claim, in any way to be an editor. Sincerely, Joshua D. Drake regards, tom lane ---(end of broadcast)--- TIP 4: Have you searched our list archives? http://archives.postgresql.org -- === The PostgreSQL Company: Command Prompt, Inc. === Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240 Providing the most comprehensive PostgreSQL solutions since 1997 http://www.commandprompt.com/ ---(end of broadcast)--- TIP 6: explain analyze is your friend
Re: [DOCS] Maintenance and External Projects (try 2)
On Friday 14 July 2006 15:23, Joshua D. Drake wrote:
> Tom Lane wrote:
> > "Joshua D. Drake" <[EMAIL PROTECTED]> writes:
> >> Please let me know if there is anything else you would like me to do or
> >> add.
> >
> > A round of copy-editing seems indicated, at least.
>
> Oh, no doubt. I tried to fix as much as I find, including a bunch of
> stuff already there. However, I do not claim, in any way to be an editor.
>
The following patches provide some editorializing for Joshua's patches.
--
Robert Treat
Build A Brighter LAMP :: Linux Apache {middleware} PostgreSQL
Index: doc/src/sgml/external-projects.sgml
===
RCS file: /projects/cvsroot/pgsql/doc/src/sgml/external-projects.sgml,v
retrieving revision 1.10
diff -c -r1.10 external-projects.sgml
*** doc/src/sgml/external-projects.sgml 10 Mar 2006 19:10:47 - 1.10
--- doc/src/sgml/external-projects.sgml 15 Jul 2006 02:22:02 -
***
*** 1,29
! External Projects
PostgreSQL is a complex software project,
!and managing it is difficult. We have found that many
enhancements to PostgreSQL can be more
!efficiently developed separately from the core project. Separate
!projects can
!have their own developer teams, email lists, bug tracking,
!and release schedules. While their independence makes
!development easier, it makes users' jobs harder. They have to hunt
!around looking for database enhancements to meet their needs.
!This section describes some of the more popular externally
!developed enhancements and guides you on how to find them.
!Many PostgreSQL-related projects are
!hosted at either
!http://gborg.postgresql.org";>GBorg
!or http://pgfoundry.org";>pgFoundry.
!There are other PostgreSQL-related projects that are hosted
!elsewhere, but you will have to do an Internet search to find them.
--- 1,34
! PgFoundry and External Projects
PostgreSQL is a complex software project,
!and managing the project is difficult. We have found that many
enhancements to PostgreSQL can be more
!efficiently developed separately from the core project.
!
!
!
!To help our community with the development of their external projects,
!we have created the http://www.pgfoundry.org/";>PgFoundry.
!http://www.pgfoundry.org/";>PgFoundry is built using the
!GForge software project and is similar to SourceForge in its feature set. If
!you have a PostgreSQL related Open Source project that you would like to
!develop and need project management resources such as mailing lists, forums,
!bug tracking, and CVS, please feel free to create a new project.
!Secondly, many PostgreSQL-related projects are
!still hosted at http://gborg.postgresql.org";>GBorg.
!GBorg is the original external community developer site, and while it is
!currently closed to new projects in favor of PgFoundry, it still contains
!many active and relevant projects. There are other popular PostgreSQL
!related projects that are hosted independently as well at other community
!sites such as http://www.sf.net";>SourceForge. You should
!google if you don't find the project you are looking for.
***
*** 36,46
PostgreSQL includes very few interfaces
with the base distribution. libpq is packaged because
!it is the primary C interface and many other
!interfaces are built on top of it. ecpg is packaged
!because it is tied to the server-side grammar so is very dependent
!on the database version. All the other interfaces are independent
!projects and must be installed separately.
--- 41,50
PostgreSQL includes very few interfaces
with the base distribution. libpq is packaged because
!it is the primary dependecy of most interfaces available to PostgreSQL.
!We also package ecpg because it is tied to the
!server-side grammar. All other interfaces, such as PHP, Perl, Python,
!and Ruby, are external projects.
***
*** 52,115
This is the most common interface for Windows
!applications.
!
!
!
!
!
! pgjdbc
!
!
!A JDBC interface.
! Npgsql
!.Net interface for more recent
!Windows applications.
! libpqxx
!A newer C++ interface.
! libpq++
!An older C++ interface.
! pgperl
!A Perl interface with an API similar
!to libpq.
! DBD-Pg
!A Perl interface that uses the
!DBD-st
