Re: [Firebird-docs] Conversion of fbutil-*

2020-06-15 Thread Mark Rotteveel

On 15-06-2020 20:24, Alexey Kovyazin (ak) wrote:
...

Another question - do you plan to convert also Developers Guide?


Yes, that is the plan.

Mark
--
Mark Rotteveel


___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


Re: [Firebird-docs] Conversion of fbutil-*

2020-06-15 Thread Paul Vinkenoog
Mark Rotteveel wrote:

> I was planning on converting the fbutil-* documentation next, however I 
> was wondering how to approach this. Historically, we have released those 
> as individual documentation, while at the same time they were also 
> intended to be a single volume (the "Firebird Command Line Utilities" book).
>
> Should I convert them individually (and 'throw away' the fbutil-intro, 
> fbutil-outro and fbutil-appendix that are only referred from the 
> "Firebird Command Line Utilities" book), or should I try to preserve 
> this by 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


___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


Re: [Firebird-docs] Conversion of fbutil-*

2020-06-15 Thread Alexey Kovyazin (ak)
Hello Mark,

I think it is necesary to keep the current structure, and unite them only
virtually, since "command line tools" is a weak basis for grouping such
different tools.
Theoretically, they should be parts of Firebird Admin Guide, but now they
are just pieces.

Another question - do you plan to convert also Developers Guide?


Regards,
Alexey Kovyazin


пн, 15 июн. 2020 г., 21:13 Mark Rotteveel :

> I was planning on converting the fbutil-* documentation next, however I
> was wondering how to approach this. Historically, we have released those
> as individual documentation, while at the same time they were also
> intended to be a single volume (the "Firebird Command Line Utilities"
> book).
>
> Should I convert them individually (and 'throw away' the fbutil-intro,
> fbutil-outro and fbutil-appendix that are only referred from the
> "Firebird Command Line Utilities" book), or should I try to preserve
> this by allowing them to be built as individual books and as a combined
> volume?
>
> I should note that the text in the intro and outro is outdated because
> it wasn't updated for several utilitities that are actually documented
> (like gfix, gstat and isql).
>
> Mark
> --
> Mark Rotteveel
>
>
> ___
> Firebird-docs mailing list
> Firebird-docs@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/firebird-docs
>
___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs


[Firebird-docs] Conversion of fbutil-*

2020-06-15 Thread Mark Rotteveel
I was planning on converting the fbutil-* documentation next, however I 
was wondering how to approach this. Historically, we have released those 
as individual documentation, while at the same time they were also 
intended to be a single volume (the "Firebird Command Line Utilities" book).


Should I convert them individually (and 'throw away' the fbutil-intro, 
fbutil-outro and fbutil-appendix that are only referred from the 
"Firebird Command Line Utilities" book), or should I try to preserve 
this by allowing them to be built as individual books and as a combined 
volume?


I should note that the text in the intro and outro is outdated because 
it wasn't updated for several utilitities that are actually documented 
(like gfix, gstat and isql).


Mark
--
Mark Rotteveel


___
Firebird-docs mailing list
Firebird-docs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/firebird-docs