Re: [pgadmin-hackers] pgAdmin3 doc location
Dave Page wrote: I think share/doc/lang_country in parallel with share/ui/lang_country. pgAdmin will now try to locate a doc version that fits the language settings, and will fall back to en_US. The options setting is removed. Regards, Andreas ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [pgadmin-hackers] pgAdmin3 doc location
Dave Page wrote: Oh right, OK. In that case I'll take a look. Building a chm from htmls is no problem. Dunno how you reference individual pages though... Not chm, just the hhp, hhc and hhk file and their subfolders. I haven't been deeper into this, but we seem to need this source level (alternatively, this can be put into a zip file). Regards, Andreas ---(end of broadcast)--- TIP 4: Don't 'kill -9' the postmaster
Re: [pgadmin-hackers] pgAdmin3 doc location
It's rumoured that Andreas Pflug once said: > Dave Page wrote: > >>Dunno, you wanted the web support for the help! If you want to remove >>it, go ahead. >> > I invented the web help for *pgsql* help, which depends on the system > in use, and may change while pgAdmin is still used (I'm using the 7.4 > doc, and will always use the newest). BTW, we should drop a note in > the doc that some pgAdmin3 options depend on the backend, and may not > be > available for older versions. Yeah, I know - I'm just messin with ya! Seriously though, we need to be careful about what docs *we* use, and what we say other people should use. We will never release pgAdmin for an unreleased version of PostgreSQL (even if it's in feature freeze) - catalogues etc. can change even at the last minute. We should be sure we absolutely know what versions we are coding for and make pgAdmin behave appropriately (not that we haven't been afaik). > I'll recode pgAdmin help calling as soon as we have agreed where files > should go for release installs. I'd vote to put them under the existing > ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't > like that... Just give me your vote for a better place. I think share/doc/lang_country in parallel with share/ui/lang_country. That's where I put them now iirc. > I haven't worked with HTMLWorkshop before, it's hopefully easy to > import html files into a htmlws project at a later time. Can you do > that? I just tried the pgadmin2 help directory under win32 and gtk2 > (wxHtmlHelpController) and it displayed nicely. Oh right, OK. In that case I'll take a look. Building a chm from htmls is no problem. Dunno how you reference individual pages though... > I tend to fix things so fast, that I forget they ever existed :-) > Therefore, I didn't mention it. :-) Regards, Dave ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [pgadmin-hackers] pgAdmin3 doc location
Jean-Michel POURE wrote: Maybe docs/lang_Country is easier to maintain because you will be able to "ls -l docs" and see how many docs are translated... Dave? We will deliver .mo files and documentation in the same packages, like : - http://www.pgadmin.org/snapshots/linux/redhat9/RPMS - http://www.pgadmin.org/snapshots/linux/mandrake91/RPMS Are you able to switch back to English when a French page does not exist? No, because after the root file for help is located, the help controller will handle all stuff itself, it's merely a big structured single document. There are no side entries. Partial translation won't work, all or nothing. It's only the application help ("contents") that will be translatable, the pgsql doc is external. Of course, the user might point to an external site that's providing translated pgsql doc, hopefully all page names are identical Regards, Andreas ---(end of broadcast)--- TIP 5: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faqs/FAQ.html
[pgadmin-hackers] pgAdmin3 doc location
Hi Dave, I've seen you just added options-tab doc under en_US/*.html. I wanted to comment on doc location before, just forgot to do it. I think making the location for application documentation doesn't make sense, because each version of the binary should be packed with the exact matching doc version. Therefore, only one version is needed. On the other side, if the doc location is well-known to us, we could easily switch directories to the best matching language version (fall-back language will be of course en_US). Additionally, if we switch to a different format (e.g. HTML workstop) to support search and index, upgrading the setting wouldn't be possible anyway. Regards, Andreas ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [pgadmin-hackers] pgAdmin3 doc location
> -Original Message- > From: Andreas Pflug [mailto:[EMAIL PROTECTED] > Sent: 23 June 2003 16:09 > To: Dave Page > Cc: [EMAIL PROTECTED] > Subject: pgAdmin3 doc location > > > Hi Dave, > I've seen you just added options-tab doc under en_US/*.html. > I wanted to comment on doc location before, just forgot to do it. I > think making the location for application documentation doesn't make > sense, because each version of the binary should be packed with the > exact matching doc version. Therefore, only one version is > needed. On the other side, if the doc location is well-known > to us, we could > easily switch directories to the best matching language version > (fall-back language will be of course en_US). Additionally, > if we switch > to a different format (e.g. HTML workstop) to support search > and index, > upgrading the setting wouldn't be possible anyway. Yeah, that's been on my mind as well. The problem is, how do you specify a higher location that will still allow web versions to work? Or do you propose junking web versions of the app docs and searching for them using a similar algorithm to that used to find xrcs? BTW, did you get a chance to look at the row insert bug I mentioned in the edit grid? Regards, Dave. ---(end of broadcast)--- TIP 3: if posting/reading through Usenet, please send an appropriate subscribe-nomail command to [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [pgadmin-hackers] pgAdmin3 doc location
> -Original Message- > From: Andreas Pflug [mailto:[EMAIL PROTECTED] > Sent: 23 June 2003 16:35 > To: Dave Page > Cc: [EMAIL PROTECTED] > Subject: Re: pgAdmin3 doc location > > > Dave Page wrote: > > >Yeah, that's been on my mind as well. The problem is, how do you > >specify a higher location that will still allow web versions > to work? > >Or do you propose junking web versions of the app docs and searching > >for them using a similar algorithm to that used to find xrcs? > > > > > What do we need web versions for? Help files are tied to the > app just as > dlg resources are. Dunno, you wanted the web support for the help! If you want to remove it, go ahead. > >BTW, did you get a chance to look at the row insert bug I > mentioned in > >the edit grid? > > > Insert of empty cols don't insert NULL any more, thus serial as any > other column with a default value are handled now corretly. Cool, thanks. Regards, Dave. ---(end of broadcast)--- TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]
Re: [pgadmin-hackers] pgAdmin3 doc location
On Monday 23 June 2003 18:26, Andreas Pflug wrote: > I'd vote to put them under the existing > ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't > like that... Just give me your vote for a better place. Maybe docs/lang_Country is easier to maintain because you will be able to "ls -l docs" and see how many docs are translated... We will deliver .mo files and documentation in the same packages, like : - http://www.pgadmin.org/snapshots/linux/redhat9/RPMS - http://www.pgadmin.org/snapshots/linux/mandrake91/RPMS Are you able to switch back to English when a French page does not exist? Cheers, Jean-Michel ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [pgadmin-hackers] pgAdmin3 doc location
Dave Page wrote: Yeah, that's been on my mind as well. The problem is, how do you specify a higher location that will still allow web versions to work? Or do you propose junking web versions of the app docs and searching for them using a similar algorithm to that used to find xrcs? What do we need web versions for? Help files are tied to the app just as dlg resources are. BTW, did you get a chance to look at the row insert bug I mentioned in the edit grid? Insert of empty cols don't insert NULL any more, thus serial as any other column with a default value are handled now corretly. Regards, Andreas ---(end of broadcast)--- TIP 2: you can get off all lists at once with the unregister command (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])
Re: [pgadmin-hackers] pgAdmin3 doc location
Dave Page wrote: Dunno, you wanted the web support for the help! If you want to remove it, go ahead. I invented the web help for *pgsql* help, which depends on the system in use, and may change while pgAdmin is still used (I'm using the 7.4 doc, and will always use the newest). BTW, we should drop a note in the doc that some pgAdmin3 options depend on the backend, and may not be available for older versions. I'll recode pgAdmin help calling as soon as we have agreed where files should go for release installs. I'd vote to put them under the existing ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't like that... Just give me your vote for a better place. I haven't worked with HTMLWorkshop before, it's hopefully easy to import html files into a htmlws project at a later time. Can you do that? I just tried the pgadmin2 help directory under win32 and gtk2 (wxHtmlHelpController) and it displayed nicely. Insert of empty cols don't insert NULL any more, thus serial as any other column with a default value are handled now corretly. Cool, thanks. I tend to fix things so fast, that I forget they ever existed :-) Therefore, I didn't mention it. Regards, Andreas ---(end of broadcast)--- TIP 7: don't forget to increase your free space map settings