Re: [Firebird-docs] SourceForge CVS to GitHub migration done

2017-11-27 Thread Paul Vinkenoog
Helen wrote:

> 1. Created a new../refdocs/images subdir, currently containing the
> images for the ODBC manual.

Perfect.

> 2.  Created a new ../refdocs/fbodbc205 directory containing the source
> for the ODBC manual.
> 3.  Added fbodbc205 to refdocs.xml.

Ditto.

> Next thing, I have source files for the build of the CHM file, for use
> with the M$ help compiler, all zipped up.  Where should I put them?
> I'll write a little readme.

And this CHM file describes the ODBC driver? So it naturally belongs to
the Fb-ODBC 2.0.5 documentation? Then I'd put the source files
- unzipped, for easier version control - in a subdir of refdocs/fbodbc205,
e.g. refdocs/fbodbc205/chm or whichever name you think is best.

Cheers,
Paul

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


Re: [Firebird-docs] SourceForge CVS to GitHub migration done

2017-11-27 Thread Helen Borrie
Hello Mark,

>> Next thing, I have source files for the build of the CHM file, for use
>> with the M$ help compiler, all zipped up.  Where should I put them?
>> I'll write a little readme.

> What are these CHM files for? You could consider just adding them 
> (unzipped) in a specific subfolder of the repository, or create a 
> separate repository for this.

Ahm actually, I was asking PaulV that question...you may not be aware
that we don't do CHM, but the ODBC fans seem to like them.  Our
DocBook system doesn't produce it but it turned out to be relatively
simple to produce from the html that it does generate.  I could
probably produce VS help from them as well, some other time when I'm
in an experimental frame of mind.  Of course, both the CHM and VS help
compilers are proprietary Microsoft products, so some might say it
would be evil to encourage these people. ;-)

So I was really just sounding out Paul as to where he thought might be
a good place to put the source files for the CHM file - obviously (I
thought) *where?* relative to the parent docbook source from which
they evolved.  A different repository does not make any sense.
Tainted or not, it is still Firebird documentation.

Helen


--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


Re: [Firebird-docs] SourceForge CVS to GitHub migration done

2017-11-27 Thread Mark Rotteveel

On 2017-11-27 01:02, Helen Borrie wrote:

Actually I had to do a minor update today as I'd left something out,
so the commit messages don't all reflect what I did yesterday. ;-)

Next thing, I have source files for the build of the CHM file, for use
with the M$ help compiler, all zipped up.  Where should I put them?
I'll write a little readme.


What are these CHM files for? You could consider just adding them 
(unzipped) in a specific subfolder of the repository, or create a 
separate repository for this.



The other thing is - we don't seem to have a notification channel for
checkins to this repository.  Can something similar be done for this
one as was done for the main Firebird repo?  (After a lot of messing
about, we finally got main repo notifications coming into
firebird-checkins a few weeks ago.  I'm not sure they are perfect yet,
though)


I'll search (or ask) on firebird-devel what they did for this.

Mark

--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs