Mark Rotteveel wrote:
> >> The original convention was to name the documents in their own
> >> language, e.g. Firebird-Sicherheit.html, Firebird-Snelstartgids.pdf.
> >
> > Just to make this more clear: this convention was for the names of
> > the published files (esp. the single-file output like
Hi all,
> The original convention was to name the documents in their own
> language, e.g. Firebird-Sicherheit.html, Firebird-Snelstartgids.pdf.
Just to make this more clear: this convention was for the names of
the published files (esp. the single-file output like PDFs), not the
source files.
Hi all,
The original convention was to name the documents in their own
language, e.g. Firebird-Sicherheit.html, Firebird-Snelstartgids.pdf.
But when the new website was built - many years ago - the site
builders renamed them to their English names + a language suffix.
This was not discussed and
Hi Mark,
> I'm experimenting with producing chunked output for at least the
> language references.
>
> I have uploaded an example at
> https://www.firebirdsql.org/file/documentation/chunk/en/refdocs/fblangref40/firebird-40-language-reference.html
>
> Let me know what you think, or if you find
at them (and even if so: the content is
up-to-date) so this is probably the least urgent of jobs.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Mark Rotteveel wrote:
> I did a conversion of the Firebird 4 release notes (not yet committed).
> You can find them at:
>
> HTML:
> https://www.lawinegevaar.nl/fbdocs/html/en/rlsnotes/rlsnotes40/firebird-4-release-notes.html#rnfb40-reswords
> PDF:
>
ther, let's say,
"sub-optimal" Russian to English translation by a non-native English speaker.
And I'd be happy to make a donation for that, too.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
http
should have
the Doc index back on a single page again (except maybe for a few docs/
categories that are heavily "niche" and/or outdated and/or third-party),
with categories that make sense, and without separate lines for each
language version, because that's
he translations of this nbackup
> document. All translations are outdated compared to the current
> document, maybe it is best to leave them as is for now.
I agree.
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.
>
> I think we should correct it.
Correct :-)
Nothing dramatic, but a more logical example would be better.
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
> other opinions about this, let me know; I can still migrate them if
> necessary.
I agree, I wouldn't bother with them right now.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
y allowing them to be built as individual books and as a combined
> volume?
I think it's far more practical to have them as separate docs. I also don't
see the extra value in a combined volume if separate docs exist - but
would have nothing against it either.
Cheers,
Paul Vinkenoog
___
Mark Rotteveel wrote:
>> I also don't like the thematic subdivisioning of the current Scalar
>> Functions chapter. It has certain advantages, but they are small
>> in my opinion.
> I generally like the subdivision by target datatype: it allows me to
> drill down quickly to what I need, while
u immediately what kind of function it is.
Furthermore, this is a reference guide, not a language course or tutorial.
Most people will look here for information on a function whose name they
already know or can reasonably guess. (Again, this wil work best if you
can click the list open in the nav pa
documentation/html/en/refdocs/fblangref25/firebird-25-language-reference.html
>
That's two links to the HTML ;-)
Of course it wasn't rocket science to find the PDF:
https://firebirdsql.org/file/documentation/pdf/en/refdocs/fblangref25/firebird-25-language-reference.pdf
Hello Mark,
>>> Any objections if I just remove this caution in the new version?
>>
>> No, please correct this. I sometimes use expressions for ordering
>> levels, e.g. with IIF or DECODE constructs that return, say, the
>> numbers 1, 2 and 3, and they do the expected thing in Fb 2.5 and 3,
>>
f column 1, 2 or 3.
It would be silly anyway, because the value of X+Y may vary wildly
across rows, so which one would determine the column number
to sort by?
Maybe what they're (trying to) say is true for constant expressions
and/or expressions involving only constants and local variables in
PSQL.
Paul
Mark Rotteveel wrote:
>> I like that better and I think that, between the tables, I'd still prefer the
>> autowidth, but with 2-3 times more right-padding than left-padding.
>
> Given the text is left-aligned, why would more right-padding than
> left-padding be important?
It's easier to the
Hi MArk,
> I have updated the examples (same links):
>
> - little bit more padding in PDF
I don't see that (but can't compare with the previous rendering, obviously)
and the 'r' is still on the next line.
> - Column heading left-aligned
> - No striping
I like that better and I think that,
L tables.
All that said, I think the definition list is fine as well. A little
better in the PDF, probably because of the boldfacing of the terms (if
they are - at least they look a tad darker to me).
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird
Hello Alexey,
I didn't understand at first that that's what you wanted. A high-level ToC
for each document on the doc index page doesn't seem useful to me and
only clutters the page.
I think everbody knows what they can expect from:
- Release Notes
- Quick Start Guide
- Firebird Language
Hello Alexey,
> As you know, Firebird documentation contains a set of documents, and they
> are grouped in several pages, by the topic or type of documents, like
> Release Notes, etc.
>
> Should we consider build the overall list of the docs and put to the
> Documentation starting Page?
Mark Rotteveel wrote:
>> Ok, I'll change it to media-type screen, which will start a chapter on a
>> new page, but doesn't care if it is recto or verso.
>
> And published
Thanks, Mark!
Cheers,
Paul
___
Firebird-docs mailing list
Mark Rotteveel wrote:
>> Is it possible to generate the PDF's so that chapters start on a fresh
>> page but not necessarily on an uneven page,
>> like they do now? These blank pages between chapters are irritating
>> when reading on-screen.
>
> As I thought the primary reason we had PDF was for
Mark Rotteveel wrote:
> I have migrated the first documents to asciidoc:
Looking good!
> https://www.firebirdsql.org/file/documentation/pdf/en/firebirddocs/docbuildhowto/firebird-docbuilding-howto.pdf
Is it possible to generate the PDF's so that chapters start on a fresh page but
not
rd
spacing are
definitely less. (And the line spacing as well, but only marginally so: 26 px
instead of 27.)
On you comparison image, another font is used and I can clearly see the height
difference
there.
So let's leave it at that!
Cheers,
Paul Vinkenoog
__
Hi Mark,
> > - Font size is rather biggish. Maybe 10% smaller or so would be better and
> > more in line with the average informative website?
>
> I tweaked the font size a bit:
> https://www.lawinegevaar.nl/fbdocs/html/en/experiment/fblangref25/fblangref25.html
The font size is exactly the same
hat, Mark!
I know from (past) experience how incredibly time-consuming doc writing
and styling are.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Mark Rotteveel wrote:
> > - Some of the fonts are not very pleasant to the eye (at least my eye); they
> > look horizontally compressed.
> I made some minor tweaks:
> https://www.lawinegevaar.nl/fbdocs/pdf/en/experiment/fblangref25/fblangref25.pdf
>
> Specifically I changed:
> - admonition
with the slider
(which, I admit, is
pretty pointless) it still looks good, with the nav focus just following
without any up-and-down
bouncing going on.
My 2 cts.
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
ht
Mark Rotteveel wrote:
> On 11-05-2020 14:30, Paul Vinkenoog wrote:
> > Dmitry Yemanov wrote:
> >
> >> 4) I don't like how titles of / blocks are rendered,
> >> they're just italic of the default size. I'd prefer a bigger font (and
> >> maybe a diff
ifference that doesn't exist.
Of course, without lines or borders (i.e. if the only alternative is no
visual support at all) striping may be the lesser evil.
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
of course they are not. It's also totally
unnecessary, because rows are separated by lines.
Striping makes tables 'noisy' and less readable. IMO we should do
away with it.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.source
actually).
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Mark Rotteveel wrote:
[PDF]:
> > - In tables, sometimes the first column is centered and the second one
> > left-justified; sometimes the first is right-justified and the second
> > left-justiified.
> > I know this is already the case in the existing LangRef, but I find it
> > absolutely
> >
Mart Rotteveel wrote:
> > First impressions of the HTML (after 1-2 minutes of reading and scrolling):
> >
> > - Font size is rather biggish. Maybe 10% smaller or so would be better and
> > more in line with the average informative website?
>
> The font size is based on the default font size in
s.
(OK, I realize this is in the source and not in the rendering, but I'll leave it
here as a reminder ;-))
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
place where it isn't needed. If there's an option to turn the animation off,
I would prefer that. (The fact as such that the ToC follows the scrolling is
of course very useful.)
- All in all though, it already looks _much better_ than our current HTM
hange this to whatever you deem best, as long as in-block line
indentations are preserved (except where they make no sense at all,
but in those cases you should probably consult the author).
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing l
Norman Dunbar wrote:
> I actually prefer chunky html, sorry. It loads quicker over single files.
>
> True, I can't search the whole file, but if I needed that I'd use the pdf.
>
> Having said that, I'm happy to lose the chunky version, if necessary.
I also prefer the chunked HTML. But of
thing anyway, at a time
when I was also making some contributions to the FOP project in order
to get our Firebird PDF's right.
Cheers,
Paul Vinkenoog
PS: Apologies for my consistently slow replies!
___
Firebird-docs mailing list
Firebird-docs@lis
ed. I don't have time to delve into this and it doesn't seem very urgent.
If and when Japanese authors/translators consider this problematic, we can
work with them to solve the issue.
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.
s you suggested, we could just wait until the next Japanese document needs
to be built.
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Mark Rotteveel wrote:
> I built an equivalent for ttcmetrics so I could fix the issue with the
> Japanese rendering. I ran into problems with doing it from Ant (probably
> due to Java version mismatches) and decided it was easier to just do it
> from Gradle than spend time investigating
Helen Borrie wrote:
> Sorry for the delay replying. I have had a stroke with various
> negative effects that are not being rehabilitated very quickly.
Oh dear. I hope you're doing alright, Helen! Please take care.
> Working the github stuff is still defeating me.
> Can I send the updated 2.5.9
have you added gradle tasks for the three metrics
targets (t1metrics, ttfmetrics and ttcmetrics) or did you build them with ant
for now? People are going to need them, so if they're not already present
they'll have to be added sooner or later.
Hi Mark,
> > I built several HTML and PDF targets successfully. But I noticed some
> > structural
> > differences in the PDF's. The ones built with gradle opened with the
> > navigation
> > bookmarks initially all collapsed, and the 'Table of Contents' bookmark
> > entirely
> > missing.
>
> I
Mark Rotteveel wrote:
> I had noticed the changes in margin, but I actually thought it looked
> better ;).
So do I, so let's keep them that way :-)
Paul
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
Hello Mark,
> Due to incompatible changes with regard to how the stylesheets are
> specified and resolved (specifically the imports), the Ant build doesn't
> work. (...)
> I'm wondering if I should invest time to 'fix' that or not. I think it
> is probably better to switch-over and tackle any
Hi Mark,
> I'm currently working on a gradle build to replace the current ant-based
> build for the documentation.
>
> It is a work-in-progress, but I'd really like some other eyes on its
> output. So, could some of you please try it out, look at its output and
> report any problems you see
Mark wrote:
> > Also, at lines 320-324 (that's the bit about how we used to keep tools and
> > lib binaries in the CVS repository): you've changed that to 'git
> > repository',
> > but of course they were never in there.
>
> Technically they are in the git repository as well, as I preserved the
Hi Mark,
> > I have created a pull request with some changes:
> > https://github.com/FirebirdSQL/firebird-documentation/pull/10
>
> I would really like a second pair of eyes on this, otherwise I will
> merge and release this next weekend.
Looks very good to me, but I'm still a git newbie so
ork on the documentation!
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Hi Martin,
>> I am currently on the road. It would be great if you could create the HTML
>> output.
>
> Sure, I'll do it this weekend.
OK, done.
https://www.firebirdsql.org/en/drivers-documentation/
Cheers,
Paul
___
Firebird-docs mailing list
Hi Martin,
> no, I don't have CMS access.
>
> I am currently on the road. It would be great if you could create the HTML
> output.
Sure, I'll do it this weekend.
Gruß,
Paul
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
Hi Martin,
> no, there is no particular reason. Who Who should get the html version?
We usually build HTML and PDF and place them on the website. But I forgot you
don't have CMS access (or do you?)
Anyway, you can send me the zipped HTML version but I can also build it myself
and place it on
o HTML version?
Cheers,
Paul Vinkenoog
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
Hi Martin,
> which command do I have to use to create the ODBC documentation?
This ought to do it, I guess:
build -Dbase=refdocs -Did=fbodbc205
being html, pdf, docs, monohtml, etc.
Cheers,
Paul
___
Firebird-docs mailing list
it.
Hope to hear from you soon! Please keep following this list, as this
is where we discuss doc matters and help each other - even if it's
VERY quiet sometimes ;-)
Cheers,
Paul Vinkenoog
--
Check out the vibrant tech communi
Hi Martin,
> yes, I also created the HMTL output. Do you want the zipped version?
Yes, please. I'll place it online tonight.
Cheers,
Paul
--
Check out the vibrant tech community on one of the world's most
engaging tech
Hi all,
> > I've just finished the translation of the last chapter. We have a complete
> > German language reference now. I sent Alexey the pdf. The source code is on
> > Github.
>
> That's great, Martin! Thanks for all your hard work. I see the PDF isn't
> online yet, but I'll keep an eye on
ut changes on GitHub.
You mail made me realise that I didn't know about these pull requests.
I've now added myself as a "watcher". (Like I said earlier, I'm a
complete newbie to GitHub.)
Cheers,
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
Hi Norman,
>> A number of source files in my (Windows) CVS working dir have Unix line
>> endings though, whereas their Git counterparts have DOS endings.
>>
>> That's no problem, as long as it doesn't lead to a huge number of 'changes'
>> and log messages when such a file is committed,
cur if we commit all our work to CVS before the
conversion/transition, get a fresh git clone afterwards and work only from
that. Am I right?
Cheers,
Paul Vinkenoog
--
Check out the vibrant tech community on
Hi Mark,
> I have made a few more test runs, the end result is in
> https://github.com/mrotteveel/test-firebird-documentation-3
>
> I think this would be the final run.
>
> Difference against yesterday:
>
> - Removed the d_jencks branch
> - Added a .gitignore to ignore build files
> - Added a
n of the ODBC repository this weekend. If
> it is quick to do, I'll also do a test conversion of the docs repository.
Thanks, that would be most interesting. I'm especially curious about
the preservation of the history, including branches (not that we have
many of those
opinions?
Cheers,
Paul Vinkenoog
--
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
___
Firebird-docs
gref25-structure-de.xml
Last week, Martin Köditz has completed the translation of five more chapters:
fblangref25-appx01-supplement-de.xml
fblangref25-appx04-systables-de.xml
fblangref25-appx05-montables-de.xml
fblangref25-appx07-license-de.xml
fblangref25-dochist-de.xml
They've all b
; for contribution.
No objections here, but does anybody have any experience with this kind
of migration? (Preferably including history.)
Myself, I'm a basic GIT user and I only use it locally.
Paul Vinkenoog
--
Check ou
's translations have been committed to CVS. Thanks again, Martin!
Cheers,
Paul Vinkenoog
--
Check out the vibrant tech community on one of the world's most
engaging tech sit
Hi all,
> So for now, let's take the most conservative approach and apply this
> change to the multi-page HTML build of the refdocs set only (i.e.
> LangRef and LangRefUpds) and leave everything else untouched.
I've committed the changes.
Cheers,
Paul
Hi Helen,
>> PDF is very different and already has the navigation pane, so local
>> ToCs are probably less useful there. However, we can do it if we want.
>> I've added a PDF with chapter ToCs to the above page as an example.
>
> Actually, the PDF bookmarks do the job efficiently, without
Helen wrote:
>> My preference would be the second variant (2 - 2 - 2), where...
> I prefer the second version too. It uses a bit more real estate but
> it means one doesn't have to keep reverting to the top-level TOC if
> browsing for a specific function while not knowing exactly the one you
>
Hello Mark,
> > - toc.section.depth
> >determines the deepest section level that can appear in a ToC
> >
> > - toc.max.depth
> >determines the maximum depth (= number of levels) in any ToC
> >
> > - generate.section.toc.level
> >determines up to (or rather down to) which section level
Hi all,
> I will look into the TOC issue this week. IIRC (it's been a while since
> I did any extensive work on the transformation stylesheets) TOCs are
> relatively easy to add and configure.
OK, that turned out to be infeasible from my holiday address, with a
half-broken laptop and a limited
en again, with enough TOCs in
the right places (where you can also pick up the URLs) we could probably
do without this.
Cheers,
Paul Vinkenoog
--
Find and fix application performance issues faster with Applicati
page, because FB3 hasn't been released yet.
There are probably still some rough edges to the guide, but I couldn't wait any
longer: the first packages may be built today.
If you find any errors, please let us know.
Cheers,
Paul Vinkenoog
Hi all (especially Helen),
I got suspicious when I saw the precedence of arithmetic operators listed like
this:
1: *
2: /
3: +
4: -
So I tested it:
SQL> select 1 - 3 + 3 from rdb$database;
ADD
=
1
-- so + doesn't have higher
and haven't really been keen on
> doing testing. Sorry about that.
Hope you're doing alright now!
Cheers,
Paul Vinkenoog
--
Transform Data into Opportunity.
Accelerate data analysis in your applications with
Inte
Hi Helen,
> Another thing we seem to have missed by the same method (!) was binary
> strings in hex format.
>
> Unless you have feelings against it, I should just pick up the
> relevant source from LangUpdate25, slot it into the appropriate
> places and cross-ref where needed.
Yes, please use
Hi Helen,
> > p.51 (end of first paragraph):
> > A CONTAINING search is not case-sensitive.
>
> > Maybe a comment/warning on accent-sensitivity?
>
> I think you might be the first person involved with this text who has
> day-to-day experience with data in a language with accented
> characters.
s complicated, just having the English
corrected is already a big step forward from where we are now.)
Good luck!
Paul Vinkenoog
--
Transform Data into Opportunity.
Accelerate data analysis in your applications wit
tigate/report SQL issues if
they really stick out.
Or perhaps you can first read some sections in, say, chapter 6, to get an idea
of the material and discuss the best approach after that?
Please know that we're all very glad with the help you're offering and I hope
that my rambling doesn't scare you
Hi all,
> Thank you Helen. It works now. I think somebody should correct the readmes or
> the web URL.
I'll look into it. http://www.firebirdsql.org/doclibs and
http://www.firebirdsql.org/doctools should work. Maybe someone removed the
aliases.
Cheers,
Paul
or so.
Paul Vinkenoog
--
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
too? (The HTML structure zipped, please.)
Cheers,
Paul Vinkenoog
--
Monitor Your Dynamic Infrastructure at Any Scale With Datadog!
Get real-time metrics from all of your servers, apps and tools
in one place.
SourceForge use
Hi all,
Tsutomu is right. param1 is the parameter with a 'normal' SQL data type
(i.e. not SQL_NULL). So if it is not NULL, XSQLVAR.sqldata should point
to the value and XSQLVAR.sqlind should be set to 0 (indicating NOT NULL).
To be exact: XSQLVAR.sqlind should *point to* a 0 value.
Paul
Hi all,
Could someone please email me the file qsg3.xml (or quickstartguide-3.xml,
or whatever) which lives in the manual/src/docs/firebirddocs directory of
our CVS module?
I'm on a slow and very unreliable link here and I've been struggling for
hours to wrest this file from the *@$#@!!
give me a hint.)
Unless Helen has the answer ready, I guess this is something for
Firebird-devel.
Cheers,
Paul Vinkenoog
--
___
Firebird-docs mailing list
Firebird-docs
.
Paul Vinkenoog
--
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports, App Integration
, it is not.
Cheers,
Paul Vinkenoog
--
Download BIRT iHub F-Type - The Free Enterprise-Grade BIRT Server
from Actuate! Instantly Supercharge Your Business Reports and Dashboards
with Interactivity, Sharing, Native Excel Exports
with the language.
But I guess native English speakers should have the final word on this.
After all, I'm also a non-native English speaker (as well as a non-native
Russian non-speaker ;-))
Cheers,
Paul Vinkenoog
be better off fixing that bug or adding that feature in our current
custom set.
Either way, I'm willing to do my share of the work, but again, please let's not
do it just for the sake of upgrading.
Cheers,
Paul Vinkenoog
builds *all* our manuals (including
the Release Notes) correctly in PDF, multi-page HTML and single-page HTML.
What exactly are the rendering issues you encountered?
Cheers,
Paul Vinkenoog
--
Want excitement?
Manually
of whitespace... :|
OK, so be it. You know that you can configure XMLMind's whitespace and
indentation behaviour (somewhat)? And you're not required to use XMLMind
for your editing. Just as long as the result is valid DocBook.
Paul Vinkenoog
Hi all,
Meanwhile, anybody who builds a PDF and is *really* annoyed by this new
feature
OK, this really pisses me off.
So I've fixed and re-uploaded the two documents in which this occurs.
Paul
PS:
Martin, I changed one thing (don't remember in which doc): there was a double
colon
Hi Norman,
Is it possible to set up a branch under the trunk and another under
the same position in the B_Release? Or is that not possible.
Yes, you can set up branches on branches, and branches on branches on
branches, and so on.
But the same position is not defined between branches and the
tools.jar.
Cheers,
Paul Vinkenoog
--
Master HTML5, CSS3, ASP.NET, MVC, AJAX, Knockout.js, Web API and
much more. Get web development skills now with LearnDevNow -
350+ hours of step-by-step video tutorials by Microsoft
Norman wrote:
I need to get the tools.jar to build my docs and I've found that the URL
given in the read me is forbidden 403. I'm attempting to go to
http://www.firebirdsql.org/doclibs/.
Similar problems exist with http://www.firebirdsql.org/doctools/.
Yup. I'll look into it.
Cheers,
1 - 100 of 114 matches
Mail list logo