Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the documents

2003-09-13 Thread Bruce Momjian
Dave Page wrote:
> > I have added that to the Win32 project page:
> > 
> 
> pgAdmin already has the complete document set in chm format. The
> contents files etc can be found at
> http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/. 

Where is the actual CHM file at that URL?

-- 
  Bruce Momjian|  http://candle.pha.pa.us
  [EMAIL PROTECTED]   |  (610) 359-1001
  +  If your life is a hard drive, |  13 Roberts Road
  +  Christ can be your backup.|  Newtown Square, Pennsylvania 19073

---(end of broadcast)---
TIP 8: explain analyze is your friend


Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the documents

2003-09-13 Thread Bruce Momjian
Andreas Pflug wrote:
> Bruce Momjian wrote:
> 
> >Dave Page wrote:
> >  
> >
> >>>I have added that to the Win32 project page:
> >>>
> >>>  
> >>>
> >>pgAdmin already has the complete document set in chm format. The
> >>contents files etc can be found at
> >>http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/. 
> >>
> >>
> >
> >Where is the actual CHM file at that URL?
> >  
> >
> Dave removed it from cvs, it can now be found at
> 
> http://snake.pgadmin.org/snapshots/help/en_US/pgadmin3.chm

Perfect.  URL updated.

-- 
  Bruce Momjian|  http://candle.pha.pa.us
  [EMAIL PROTECTED]   |  (610) 359-1001
  +  If your life is a hard drive, |  13 Roberts Road
  +  Christ can be your backup.|  Newtown Square, Pennsylvania 19073

---(end of broadcast)---
TIP 8: explain analyze is your friend


Re: [DOCS] Windows CHM format for the documents

2003-09-13 Thread Christopher Browne
[EMAIL PROTECTED] wrote:
> I'm not sure if it would be a bad thing to give up DocBook, but I cannot see
> anything but benefits from using this other type of document development...

I cannot see anything but problems from using this.

- The current usage allows people to work on documents as files, using
  whatever editing tools they like.  With your "server software," that
  is lost.

- Current usage uses CVS to manage changes.  This allows changes to be
  looked at and approved/rejected/modified.  I haven't any idea if
  your system uses text files in behind, it sounds like not.

- Current usage does not mandate that anyone have a synchronous
  connection to a central server that becomes bottleneck / vulnerable
  point.  

The apparent "benefit" of your tool is that it provides a tool with a
user interface that slavishly follows the Windows "CHM file" viewer.
That may be an advantage to those that want to slavishly follow
Windows development/deployment "standards," but I daresay you're NOT
in a community that is particularly interested in that sort of thing.
-- 
wm(X,Y):-write(X),write('@'),write(Y). wm('aa454','freenet.carleton.ca').
http://www3.sympatico.ca/cbbrowne/nonrdbms.html
Sturgeon's Law: 90% of *EVERYTHING* is crud.

---(end of broadcast)---
TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]


Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the documents

2003-09-13 Thread Andreas Pflug
Bruce Momjian wrote:

Dave Page wrote:
 

I have added that to the Win32 project page:

 

pgAdmin already has the complete document set in chm format. The
contents files etc can be found at
http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/. 
   

Where is the actual CHM file at that URL?
 

Dave removed it from cvs, it can now be found at

http://snake.pgadmin.org/snapshots/help/en_US/pgadmin3.chm

Regards,
Andreas


---(end of broadcast)---
TIP 9: the planner will ignore your desire to choose an index scan if your
 joining column's datatypes do not match


Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the documents

2003-09-13 Thread Darko Prenosil

- Original Message -
From: "Bruce Momjian" <[EMAIL PROTECTED]>
To: "Dave Page" <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>; <[EMAIL PROTECTED]>; "PostgreSQL Win32
port list" <[EMAIL PROTECTED]>
Sent: Saturday, September 13, 2003 6:32 PM
Subject: Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the
documents


> Dave Page wrote:
> > > I have added that to the Win32 project page:
> > >
> >
> > pgAdmin already has the complete document set in chm format. The
> > contents files etc can be found at
> > http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/.
>
> Where is the actual CHM file at that URL?

http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/pgadmin3.hhp
http://cvs.pgadmin.org/cgi-bin/viewcvs.cgi/pgadmin3/docs/en_US/pgadmin3.hhc

Are CHM project files.

There is no CHM file, because it is compiled in Make process.
You'll have to remove few pages that are actually pgadmin's help, but it is
much easier then write it again.
Pgadmin's help is organized in the way that postgresql pages are under "pg"
subdirectory, but this is nothing that simple "find-replace" cant solve. If
You wish, I'll do that, and send You the clear postgresql project files.

Regards !



---(end of broadcast)---
TIP 7: don't forget to increase your free space map settings


Re: [DOCS] Windows CHM format for the documents

2003-09-13 Thread ilkka
> - The current usage allows people to work on documents as files, using
>   whatever editing tools they like.  With your "server software," that
>   is lost.

Yes, it is harder to use any tool for editing (though not
impossible,copy/paste could be used :-).

There are benefits from using the same tool too - the output will probably
look the same throughout the document. The central server idea emphasizes
this even more I think ... and the programmatically (sp?) :-)

> - Current usage uses CVS to manage changes.  This allows changes to be
>   looked at and approved/rejected/modified.  I haven't any idea if
>   your system uses text files in behind, it sounds like not.

Creating some of the CVS features wouldn't be a problem at all. For example
storing certain situations (labeling) would be a good idea (of course the
current backuping could be used for this as well).

> - Current usage does not mandate that anyone have a synchronous
>   connection to a central server that becomes bottleneck / vulnerable
>   point.

Yes, well, nowadays most people have fixed lines (in the future more so), I
wouldn't count this a big drawback.

> The apparent "benefit" of your tool is that it provides a tool with a
> user interface that slavishly follows the Windows "CHM file" viewer.
> That may be an advantage to those that want to slavishly follow
> Windows development/deployment "standards," but I daresay you're NOT
> in a community that is particularly interested in that sort of thing.

I'm far away from favoring any particular OS. Personally I have done more
Unix/Linux development than Windows. But as long as this shouldn't be an OS
war forum, I think all OSs pretty much suck at some things, and are good at
others.

CHM is only one choice for output, and besides it's not only for Windows.
http://xchm.sourceforge.net/ there's a CHM viewer for Linux. There are more
similar kinds of viewers with slightly different file format, but they do
the same. I think that CHM has its advantages and I like using them.

I'm fine if you want to use your tools, and sorry if I bothered you...It was
just an option that I presented and you have given some good feedback of it.

Ilkka



---(end of broadcast)---
TIP 5: Have you checked our extensive FAQ?

   http://www.postgresql.org/docs/faqs/FAQ.html


Re: [pgsql-hackers-win32] [DOCS] Windows CHM format for the documents

2003-09-13 Thread Bruce Momjian
Dave Page wrote:
> > > http://snake.pgadmin.org/snapshots/help/en_US/pgadmin3.chm
> > 
> > Perfect.  URL updated.
> 
> Hang on, what URL? That's one of our dev boxs which has limited
> bandwidth - I'm happy for us to provide the hhp/hhk files for public
> consumption, but I'd rather not advertise a url to a 2+Mb file on that
> particular machine.
> 
> Darko - in another email you offered to make a pgAdmin-free version. If
> you can do that, I will put the project files and resulting chm file on
> www.postgresql.org.

Give me the updated URL when you have it.  I don't expect many people to
download the file, but I would bet web searchers might hit it.

-- 
  Bruce Momjian|  http://candle.pha.pa.us
  [EMAIL PROTECTED]   |  (610) 359-1001
  +  If your life is a hard drive, |  13 Roberts Road
  +  Christ can be your backup.|  Newtown Square, Pennsylvania 19073

---(end of broadcast)---
TIP 6: Have you searched our list archives?

   http://archives.postgresql.org