,
completely false?
Sorry, I've got no idea. But with Dmitry on the list... :-)
Cheers,
Paul Vinkenoog
BTW: 'metatdata'? (twice)
--
AppSumo Presents a FREE Video for the SourceForge Community by Eric
Ries, the creator
. But maybe we can
come up with yet another solution.
Cheers,
Paul Vinkenoog
--
BlackBerryreg; DevCon Americas, Oct. 18-20, San Francisco, CA
The must-attend event for mobile developers. Connect with experts.
Get tools
On Fri, 26 Sep 2008 17:10:26 +0200, Norman Dunbar wrote:
* The xinclude problem can be fixed using xerces as the xsl processor.
But I cannot for the life of me get it working in XSL-FO yet. I feel
another support call coming on!
Now I have not yet tried xinclude with Firebird docs, but given
/build.
Even if you don't use xincludes yourself, your build system may get broken in
the future if you don't upgrade, as soon as somebody else starts using them in
a set you work with.
Cheers,
Paul Vinkenoog
(wrestles with ants
Helen wrote:
OK, it's done, so please do a cvs update in manual/src/docs/refdocs
Are we still using cvs?
For the manual module, yes.
Dmitry, could you add Thomas to the project so he can commit his changes to
CVS? Or should I ask this in fb-admins?
I can do it if I know Thomas' SF ID.
Hi Helen,
But in case you didn't receive it: user name dommasw, user id 3560308
Done.
Thanks,
(I take it you are not planning to go to bed today... ;-) )
*Just* logging off - really! :-)
Paul
--
All the data
in
pick lists.
This is a nice feature now that we're seriously starting with the modularized
LangRef. BTW, it's hidden by default - don't ask me why. You have to enable it
via Options - Preferences - General - Features.
Cheers,
Paul Vinkenoog
found discrepancies between several types of documentation (IB guides -
statements from developers - Release Notes - Firebird Book - other
manuals). On some occasions, they *all* differed from reality :-)
Cheers,
Paul Vinkenoog
Hi all,
I've just committed a number of changes to docs/firebirddocs.xml and many
documents in the docs/firebirddocs tree. In all the documents that I maintain,
I've uncommented (or added) DOCTYPE headers and replaced XML entities with
xincludes (this last action mainly in firebirddocs.xml,
Hi Norman,
Hmm. Surely the fbdoc_vpn.xml file is as equally obsolete as the
firebirdintro.xml? The VPN method of accessing the server to upload
documents is no longer in use what with the new CMS and the
(blisteringly fast) new server? I was considering deleting that file.
Probably a good
of course read :
...
section has an id=rnfbtwo-compat but I can find no cross refernece ...
Really? ;-)
Paul Vinkenoog
--
All the data continuously generated in your IT infrastructure contains a
definitive record
Hi all,
Marius wrote:
I can help with checking and reviewing the Reference
Good! Then I suggest that we, as authors, announce it here if and when we have
a chapter ready. BTW, Steve Summers is willing to proof-read documentation and
correct/improve the English.
Cheers,
Paul Vinkenoog
idea. I switched to the Professional Edition myself last year,
but the Personal Edition is just as good for our purposes. I still
have 5.0.0 lying around (last Pers.Ed. I used), but if 5.2.1 had no
drawbacks, then let's make that one available.
Cheers,
Paul Vinkenoog
Hi Marius,
it's not simple c it's á in the documentation , this should be closed
documentation is right
You're right, thanks. I closed the issue.
Cheers,
Paul
--
Everyone hates slow websites. So do we.
Make your web
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,
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
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
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
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
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
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
.
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
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
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
or so.
Paul Vinkenoog
--
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs
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
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 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.
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
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
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 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
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
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
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
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
'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
; 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
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
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
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
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
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
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
-
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
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,
> 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
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,
> 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,
>> 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
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,
> 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
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
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
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.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
> >
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
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
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
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
__
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?
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
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
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:
>> 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
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
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,
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,
>>
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
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
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
1 - 100 of 114 matches
Mail list logo