gnucash-docs maint: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Mon Sep 9 00:33:35 EDT 2019
Updated via https://github.com/Gnucash/gnucash-docs/commit/f77e8a38 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/45767a71 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/1323c3df (commit)
from https://github.com/Gnucash/gnucash-docs/commit/73beb776 (commit)
commit f77e8a387a751c38e9eced6cf5fdf8457bf2de61
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Mon Sep 9 05:47:03 2019 +0200
FAQ: review links
Remove redundance.
Use entities, where applicable.
Improve English (Where’s -> Where is)
Explain, which FAQ is recent.
Remove g-wrap reference.
Note: Gmane seems dead.
diff --git a/guide/C/appendixb.xml b/guide/C/appendixb.xml
index 27bdf7c..4b4deaa 100644
--- a/guide/C/appendixb.xml
+++ b/guide/C/appendixb.xml
@@ -23,23 +23,23 @@
<title>Sources of Information</title>
<qandaentry id="appendixb_info_where">
- <question><para>Where’s the FAQ?</para></question>
- <answer><para>You’re looking at it. The most up-to-date copy can be found <ulink url="http://wiki.gnucash.org/wiki/FAQ">within the <application>&app;</application> Wiki</ulink>.</para></answer>
+ <question><para>Where is the FAQ?</para></question>
+ <answer><para>You’re looking at an very old copy of it. The most up-to-date copy can be found within the <ulink url="&url-wiki-faq;"><application>&app;</application> Wiki</ulink>.</para></answer>
</qandaentry>
<qandaentry id="appendixb_info_mail">
<question><para>Are there mailing lists for <application>&app;</application>?</para></question>
- <answer><para>Yes. Go to <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> to subscibe.</para></answer>
+ <answer><para>Yes. Go to <ulink url="&url-mail-li;gnucash-user" /> and <ulink url="&url-mail-li;gnucash-devel" /> to subscibe.</para></answer>
</qandaentry>
<qandaentry id="appendixb_info_mailarchive">
<question><para>Is there a searchable archive for the mailing lists?</para></question>
- <answer><para>Yes, you can search the mail list archives at <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.devel"></ulink> and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.user"></ulink> (and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.german"></ulink> if you speak German).</para></answer>
+ <answer><para>Yes, you can search the mail list archives at <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.devel" /> and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.user" /> (and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.german" /> if you speak German).</para></answer>
</qandaentry>
<qandaentry id="appendixb_info_other">
<question><para>Are there other means of obtaining support for <application>&app;</application>?</para></question>
- <answer><para>Yes. Many of the developers hang out on icq in the #gnucash discussion on irc.gnome.org. Also, there is a wiki online at <ulink url="http://wiki.gnucash.org/wiki/&app;">http://wiki.gnucash.org/wiki/&app;</ulink>.</para></answer>
+ <answer><para>Yes. Many of the developers hang out on icq in the #gnucash discussion on <ulink url="&url-irc;" />. Also, there is a <ulink url="&url-wiki;">wiki</ulink> online.</para></answer>
</qandaentry>
</qandadiv>
@@ -54,7 +54,7 @@
<qandaentry id="appendixb_general_hard2compile">
<question><para>I heard it is too hard to compile <application>&app;</application>!</para></question>
- <answer><para>This was probably true at the time when 1.6.0 was released. It is no longer true today, as almost every distribution ships with all the necessary libraries (except g-wrap, which means there is in fact <quote>one</quote> extra library to be installed before compiling <application>&app;</application>). However, by default, distributions won’t install the development packages of the required libraries, so you might need to start your distribution’s installer program and tell it to install not only the library packages but also the -devel packages. In general, it was noted that this problem concerns many applications in the gnome domain, and this also boils down to the fact that there is no such thing as <quote>one monolithic gnome package</quote>.</para></answer>
+ <answer><para>This was probably true at the time when 1.6.0 was released. It is no longer true today, as almost every distribution ships with all the necessary libraries. However, by default, distributions won’t install the development packages of the required libraries, so you might need to start your distribution’s installer program and tell it to install not only the library packages but also the -devel packages. In general, it was noted that this problem concerns many applications in the gnome domain, and this also boils down to the fact that there is no such thing as <quote>one monolithic gnome package</quote>.</para></answer>
</qandaentry>
<qandaentry id="appendixb_general_batchmode">
@@ -69,7 +69,7 @@
</qandaentry>
<qandaentry id="appendixb_general_WhyC">
- <question><para>Why is <application>&app;</application> written in C?</para></question>
+ <question><para id="appendixb_general_WhyC.q">Why is <application>&app;</application> written in C?</para></question>
<answer><para>The core functionality of <application>&app;</application> is written in C, but do not forget that much of this can be accessed through Guile (scheme). There are a number of reasons for why <application>&app;</application> is written in C. The first is historical, <application>&app;</application> was started in 1996 (or maybe even earlier!) and many of the OOP (C++, Java, Python) compilers were not yet mature and standarized enough on the variety of platforms considered at that time, so C was the only option at that time. A second reason is because the standard GUI <application>&app;</application> uses is GTK, which is written in C.</para></answer>
</qandaentry>
@@ -77,12 +77,12 @@
<question><para>Why don’t you rewrite <application>&app;</application> in programming language xyz so that I can contribute easily?</para></question>
<answer><para>The quick answer is <quote>We won’t</quote>.</para></answer>
<answer><para>The longer answer is complex but still amounts to <quote>We won’t</quote>. <application>&app;</application> is a large body of code maintained by a small group of developers who are comfortable in C and Scheme (Guile). Actually, 80% of it is in C and approx. 13% is in Scheme/Lisp. There is no valid reason that would justify rewriting this amount of existing code in a newer language. Also, creating language bindings to recent languages such as Python or Ruby or (insert your favourite language here) is labor intensive, and we’re already stretched pretty thin maintaining and developing the existing code.</para></answer>
- <answer><para>Having said that, this is an open source project and you’re free to do with it or contribute what you want. Just don’t expect much support if the reason for your changes is that you’re not willing to learn C or Scheme. Also, <application>&app;</application> used to have SWIG bindings (<ulink url="http://www.swig.org"></ulink>) which have been used for some perl programming code. According to a list discussion, these SWIG bindings might still be a way to include other languages into <application>&app;</application>, but currently they are unused and unmaintained.</para></answer>
+ <answer><para>Having said that, this is an open source project and you’re free to do with it or contribute what you want. Just don’t expect much support if the reason for your changes is that you’re not willing to learn C or Scheme. Also, <application>&app;</application> used to have SWIG bindings (<ulink url="http://www.swig.org" />) which have been used for some perl programming code. According to a list discussion, these SWIG bindings might still be a way to include other languages into <application>&app;</application>, but currently they are unused and unmaintained.</para></answer>
</qandaentry>
<qandaentry id="appendixb_general_newFeatures">
<question><para>I really want feature XYZ but <application>&app;</application> doesn’t have it. How do I get it added?</para></question>
- <answer><para>Ask nicely. :-) You can file an enhancement request at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to describe your proposed enhancement as verbosely as possible. The trick here is to learn how to give the best information to the programmers about what your proposed new feature should do. If you want to speed up development significantly, consider donating some money as described on <application>&app;</application>Development.</para></answer>
+ <answer><para>Ask nicely. :-) You can file an enhancement request at <ulink url="&url-bug-start;" />. Please bear in mind to describe your proposed enhancement as verbosely as possible. The trick here is to learn how to give the best information to the programmers about what your proposed new feature should do. If you want to speed up development significantly, consider donating some money as described on <application>&app;</application>Development.</para></answer>
</qandaentry>
<qandaentry id="appendixb_software_web">
@@ -97,13 +97,13 @@
<qandaentry id="appendixb_software_contribute">
<question><para>How can I contribute to the <application>&app;</application> project?</para></question>
- <answer><para>We’re working on a more formal process, but for now you should subscribe to the mailing list at <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> and discuss what you can contribute with the participants on the lists. Please be aware that <application>&app;</application> is a large body of code written in C and Scheme (see the FAQ above, <quote>Why is <application>&app;</application> written in C?</quote> if you want to know why). If these are languages that you are not willing to work with, consider contributing in other ways.</para></answer>
+ <answer><para>We’re working on a more formal process, but for now you should subscribe to the mailing list at <ulink url="&url-mail-li;gnucash-user" /> and <ulink url="&url-mail-li;gnucash-devel" /> and discuss what you can contribute with the participants on the lists. Please be aware that <application>&app;</application> is a large body of code written in C and Scheme (see <quote><link linkend="appendixb_general_WhyC" endterm="appendixb_general_WhyC.q"></link></quote> above, if you want to know why). If these are languages that you are not willing to work with, consider contributing in other ways.</para></answer>
</qandaentry>
<qandaentry id="appendixb_software_bugs">
<question><para>I think I found a bug. How do I report it?</para></question>
- <answer><para>First of all, try to verify that it is indeed a bug and that it has not been reported before. Search the mail list archives (see FAQ above). Then search the <ulink url="http://bugs.gnucash.org">&app; Bugzilla</ulink> database.</para>
- <para>If you feel you have indeed found a bug, you can then report it at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to report your bug as verbosely as possible. The trick here is to learn how to give the best information to the programmers about how to reproduce bugs. A Programmer will usually only be able to fix a bug they can see, if you can’t make the programmer see your bug, it won’t get fixed!</para></answer>
+ <answer><para>First of all, try to verify that it is indeed a bug and that it has not been reported before. Search the mail list archives (see FAQ above). Then search the <ulink url="&url-bug-start;">&app; Bugzilla</ulink> database.</para>
+ <para>If you feel you have indeed found a bug, you can then report it at <ulink url="&url-bug-start;" />. Please bear in mind to report your bug as verbosely as possible. The trick here is to learn how to give the best information to the programmers about how to reproduce bugs. A Programmer will usually only be able to fix a bug they can see, if you can’t make the programmer see your bug, it won’t get fixed!</para></answer>
</qandaentry>
</qandadiv>
commit 45767a71df5908e5c83e5061f030c9d3106c3d01
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Mon Sep 9 05:42:24 2019 +0200
Add ENTITY url-irc
diff --git a/docbook/gnc-docbookx.dtd b/docbook/gnc-docbookx.dtd
index 72a38ad..7af5f77 100644
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@ -65,6 +65,7 @@ own entity definitions to use across all of our DocBook pages. -->
<!ENTITY url-bug-search "https://bugs.gnucash.org/query.cgi">
<!ENTITY url-bug-browse "https://bugs.gnucash.org/describecomponents.cgi">
<!ENTITY url-gnome-dev "https://developer.gnome.org/"> <!-- Append the desired topic -->
+<!ENTITY url-irc "irc://irc.gnome.org/gnucash">
<!ENTITY url-gnu "https://www.gnu.org/"> <!-- Append the desired topic -->
<!ENTITY url-wiki-faq "https://wiki.gnucash.org/wiki/FAQ">
<!ENTITY url-mail-li "https://lists.gnucash.org/mailman/listinfo/"> <!-- Append the desired list -->
commit 1323c3dfe2afc24998ed21059cec3c6b6e795b44
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Sun Sep 8 23:28:07 2019 +0200
Use <qandaset> for FAQ
diff --git a/guide/C/appendixb.xml b/guide/C/appendixb.xml
index 842c989..27bdf7c 100644
--- a/guide/C/appendixb.xml
+++ b/guide/C/appendixb.xml
@@ -5,6 +5,8 @@
(Do not remove this comment block.)
Version: 2.0.0
Last modified: July 9th 2006
+ Converted to qandaset 2019-09-09 by Frank H. Ellenberger
+
Maintainers:
Chris Lyttle <chris at wilddev.net>
Author:
@@ -13,128 +15,131 @@
Translators:
(translators put your name and email here)
-->
- <appendix id="appendixb">
- <title>Frequently Asked Questions</title>
- <para>This is a list of questions asked on the mailing lists for which there really is no section in the documentation covering the subject.</para>
- <sect1 id="appendixb_info">
+<appendix id="appendixb">
+ <title>Frequently Asked Questions</title>
+ <abstract><para>This is a list of questions asked on the mailing lists for which there really is no section in the documentation covering the subject.</para></abstract>
+ <qandaset defaultlabel='qanda'>
+ <qandadiv id="appendixb_info">
<title>Sources of Information</title>
- <sect2 id="appendixb_info_where">
- <title>Q: Where’s the FAQ?</title>
- <para>A: You’re looking at it. The most up-to-date copy can be found <ulink url="http://wiki.gnucash.org/wiki/FAQ">within the <application>&app;</application> Wiki</ulink>.</para>
- </sect2>
+ <qandaentry id="appendixb_info_where">
+ <question><para>Where’s the FAQ?</para></question>
+ <answer><para>You’re looking at it. The most up-to-date copy can be found <ulink url="http://wiki.gnucash.org/wiki/FAQ">within the <application>&app;</application> Wiki</ulink>.</para></answer>
+ </qandaentry>
- <sect2 id="appendixb_info_mail">
- <title>Q: Are there mailing lists for <application>&app;</application>?</title>
- <para>A: Yes. Go to <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> to subscibe.</para>
- </sect2>
+ <qandaentry id="appendixb_info_mail">
+ <question><para>Are there mailing lists for <application>&app;</application>?</para></question>
+ <answer><para>Yes. Go to <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> to subscibe.</para></answer>
+ </qandaentry>
- <sect2 id="appendixb_info_mailarchive">
- <title>Q: Is there a searchable archive for the mailing lists?</title>
- <para>A: Yes, you can search the mail list archives at <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.devel"></ulink> and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.user"></ulink> (and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.german"></ulink> if you speak German).</para>
- </sect2>
+ <qandaentry id="appendixb_info_mailarchive">
+ <question><para>Is there a searchable archive for the mailing lists?</para></question>
+ <answer><para>Yes, you can search the mail list archives at <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.devel"></ulink> and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.user"></ulink> (and <ulink url="http://news.gmane.org/gmane.comp.gnome.apps.gnucash.german"></ulink> if you speak German).</para></answer>
+ </qandaentry>
- <sect2 id="appendixb_info_other">
- <title>Q: Are there other means of obtaining support for <application>&app;</application>?</title>
- <para>A: Yes. Many of the developers hang out on icq in the #gnucash discussion on irc.gnome.org. Also, there is a wiki online at <ulink url="http://wiki.gnucash.org/wiki/&app;">http://wiki.gnucash.org/wiki/&app;</ulink>.</para>
- </sect2>
- </sect1>
+ <qandaentry id="appendixb_info_other">
+ <question><para>Are there other means of obtaining support for <application>&app;</application>?</para></question>
+ <answer><para>Yes. Many of the developers hang out on icq in the #gnucash discussion on irc.gnome.org. Also, there is a wiki online at <ulink url="http://wiki.gnucash.org/wiki/&app;">http://wiki.gnucash.org/wiki/&app;</ulink>.</para></answer>
+ </qandaentry>
+ </qandadiv>
- <sect1 id="appendixb_general">
+ <qandadiv id="appendixb_general">
<title>General Information</title>
- <sect2 id="appendixb_software_windows">
- <title>Q: Can I run <application>&app;</application> on Windows?</title>
- <para>A: Yes. Starting with release 2.2.0, <application>&app;</application> is also available on Windows.</para>
- <para>Other related options would be colinux, VMWare and a windows-based X-server hosting a remote <application>&app;</application> session.</para>
- </sect2>
-
- <sect2 id="appendixb_general_hard2compile">
- <title>Q: I heard it is too hard to compile <application>&app;</application>!</title>
- <para>A: This was probably true at the time when 1.6.0 was released. It is no longer true today, as almost every distribution ships with all the necessary libraries (except g-wrap, which means there is in fact <quote>one</quote> extra library to be installed before compiling <application>&app;</application>). However, by default, distributions won’t install the development packages of the required libraries, so you might need to start your distribution’s installer program and tell it to install not only the library packages but also the -devel packages. In general, it was noted that this problem concerns many applications in the gnome domain, and this also boils down to the fact that there is no such thing as <quote>one monolithic gnome package</quote>.</para>
- </sect2>
-
- <sect2 id="appendixb_general_batchmode">
- <title>Q: Is there a batch mode (non-interactive) available for <application>&app;</application>, for building reports, etc?</title>
- <para>A: No, for now <application>&app;</application> must be run interactively.</para>
- </sect2>
-
- <sect2 id="appendixb_general_multuser">
- <title>Q: Can multiple people access the same datafile in <application>&app;</application>?</title>
- <para>A: You can have multiple people with access to the same datafile, but they cannot use the data file simultaneously.</para>
- <para>To setup multi-person access, all the people must have read/write access to the directory containing the file (to read the other’s created files, and to create new files). One way to do this is by creating a user group and setting the data directory to be owned by the shared group and set to mode 2775. The <quote>2</quote> makes the directory setgid which copies the permissions to all files.</para>
- </sect2>
-
- <sect2 id="appendixb_general_WhyC">
- <title>Q: Why is <application>&app;</application> written in C?</title>
- <para>A: The core functionality of <application>&app;</application> is written in C, but do not forget that much of this can be accessed through Guile (scheme). There are a number of reasons for why <application>&app;</application> is written in C. The first is historical, <application>&app;</application> was started in 1996 (or maybe even earlier!) and many of the OOP (C++, Java, Python) compilers were not yet mature and standarized enough on the variety of platforms considered at that time, so C was the only option at that time. A second reason is because the standard GUI <application>&app;</application> uses is GTK, which is written in C.</para>
- </sect2>
-
- <sect2 id="appendixb_general_rewrite">
- <title>Q: Why don’t you rewrite <application>&app;</application> in programming language xyz so that I can contribute easily?</title>
- <para>A: The quick answer is <quote>We won’t</quote>. The longer answer is complex but still amounts to <quote>We won’t</quote>. <application>&app;</application> is a large body of code maintained by a small group of developers who are comfortable in C and Scheme (Guile). Actually, 80% of it is in C and approx. 13% is in Scheme/Lisp. There is no valid reason that would justify rewriting this amount of existing code in a newer language. Also, creating language bindings to recent languages such as Python or Ruby or (insert your favourite language here) is labor intensive, and we’re already stretched pretty thin maintaining and developing the existing code.</para>
- <para>Having said that, this is an open source project and you’re free to do with it or contribute what you want. Just don’t expect much support if the reason for your changes is that you’re not willing to learn C or Scheme. Also, <application>&app;</application> used to have SWIG bindings (<ulink url="http://www.swig.org"></ulink>) which have been used for some perl programming code. According to a list discussion, these SWIG bindings might still be a way to include other languages into <application>&app;</application>, but currently they are unused and unmaintained.</para>
- </sect2>
-
- <sect2 id="appendixb_general_newFeatures">
- <title>Q: I really want feature XYZ but <application>&app;</application> doesn’t have it. How do I get it added?</title>
- <para>A: Ask nicely. :-) You can file an enhancement request at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to describe your proposed enhancement as verbosely as possible. The trick here is to learn how to give the best information to the programmers about what your proposed new feature should do. If you want to speed up development significantly, consider donating some money as described on <application>&app;</application>Development.</para>
- </sect2>
-
- <sect2 id="appendixb_software_web">
- <title>Q: Is there a web interface available for <application>&app;</application>?</title>
- <para>A: No</para>
- </sect2>
-
- <sect2 id="appendixb_software_security">
- <title>Q: How can I provide security for <application>&app;</application> data using CFS, etc.)</title>
- <para>A: Unanswered</para>
- </sect2>
-
- <sect2 id="appendixb_software_contribute">
- <title>Q: How can I contribute to the <application>&app;</application> project?</title>
- <para>A: We’re working on a more formal process, but for now you should subscribe to the mailing list at <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> and discuss what you can contribute with the participants on the lists. Please be aware that <application>&app;</application> is a large body of code written in C and Scheme (see the FAQ above, <quote>Why is <application>&app;</application> written in C?</quote> if you want to know why). If these are languages that you are not willing to work with, consider contributing in other ways.</para>
- </sect2>
-
- <sect2 id="appendixb_software_bugs">
- <title>Q: I think I found a bug. How do I report it?</title>
- <para>A: First of all, try to verify that it is indeed a bug and that it has not been reported before. Search the mail list archives (see FAQ above). Then search the <ulink url="http://bugs.gnucash.org">&app; Bugzilla</ulink> database.</para>
- <para>If you feel you have indeed found a bug, you can then report it at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to report your bug as verbosely as possible. The trick here is to learn how to give the best information to the programmers about how to reproduce bugs. A Programmer will usually only be able to fix a bug they can see, if you can’t make the programmer see your bug, it won’t get fixed!</para>
- </sect2>
-
- </sect1>
- <sect1 id="appendixb_using">
+ <qandaentry id="appendixb_software_windows">
+ <question><para>Can I run <application>&app;</application> on Windows?</para></question>
+ <answer><para>Yes. Starting with release 2.2.0, <application>&app;</application> is also available on Windows.</para></answer>
+ <answer><para>Other related options would be colinux, VMWare and a windows-based X-server hosting a remote <application>&app;</application> session.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_hard2compile">
+ <question><para>I heard it is too hard to compile <application>&app;</application>!</para></question>
+ <answer><para>This was probably true at the time when 1.6.0 was released. It is no longer true today, as almost every distribution ships with all the necessary libraries (except g-wrap, which means there is in fact <quote>one</quote> extra library to be installed before compiling <application>&app;</application>). However, by default, distributions won’t install the development packages of the required libraries, so you might need to start your distribution’s installer program and tell it to install not only the library packages but also the -devel packages. In general, it was noted that this problem concerns many applications in the gnome domain, and this also boils down to the fact that there is no such thing as <quote>one monolithic gnome package</quote>.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_batchmode">
+ <question><para>Is there a batch mode (non-interactive) available for <application>&app;</application>, for building reports, etc?</para></question>
+ <answer><para>No, for now <application>&app;</application> must be run interactively.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_multuser">
+ <question><para>Can multiple people access the same datafile in <application>&app;</application>?</para></question>
+ <answer><para>You can have multiple people with access to the same datafile, but they cannot use the data file simultaneously.</para>
+ <para>To setup multi-person access, all the people must have read/write access to the directory containing the file (to read the other’s created files, and to create new files). One way to do this is by creating a user group and setting the data directory to be owned by the shared group and set to mode 2775. The <quote>2</quote> makes the directory setgid which copies the permissions to all files.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_WhyC">
+ <question><para>Why is <application>&app;</application> written in C?</para></question>
+ <answer><para>The core functionality of <application>&app;</application> is written in C, but do not forget that much of this can be accessed through Guile (scheme). There are a number of reasons for why <application>&app;</application> is written in C. The first is historical, <application>&app;</application> was started in 1996 (or maybe even earlier!) and many of the OOP (C++, Java, Python) compilers were not yet mature and standarized enough on the variety of platforms considered at that time, so C was the only option at that time. A second reason is because the standard GUI <application>&app;</application> uses is GTK, which is written in C.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_rewrite">
+ <question><para>Why don’t you rewrite <application>&app;</application> in programming language xyz so that I can contribute easily?</para></question>
+ <answer><para>The quick answer is <quote>We won’t</quote>.</para></answer>
+ <answer><para>The longer answer is complex but still amounts to <quote>We won’t</quote>. <application>&app;</application> is a large body of code maintained by a small group of developers who are comfortable in C and Scheme (Guile). Actually, 80% of it is in C and approx. 13% is in Scheme/Lisp. There is no valid reason that would justify rewriting this amount of existing code in a newer language. Also, creating language bindings to recent languages such as Python or Ruby or (insert your favourite language here) is labor intensive, and we’re already stretched pretty thin maintaining and developing the existing code.</para></answer>
+ <answer><para>Having said that, this is an open source project and you’re free to do with it or contribute what you want. Just don’t expect much support if the reason for your changes is that you’re not willing to learn C or Scheme. Also, <application>&app;</application> used to have SWIG bindings (<ulink url="http://www.swig.org"></ulink>) which have been used for some perl programming code. According to a list discussion, these SWIG bindings might still be a way to include other languages into <application>&app;</application>, but currently they are unused and unmaintained.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_general_newFeatures">
+ <question><para>I really want feature XYZ but <application>&app;</application> doesn’t have it. How do I get it added?</para></question>
+ <answer><para>Ask nicely. :-) You can file an enhancement request at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to describe your proposed enhancement as verbosely as possible. The trick here is to learn how to give the best information to the programmers about what your proposed new feature should do. If you want to speed up development significantly, consider donating some money as described on <application>&app;</application>Development.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_software_web">
+ <question><para>Is there a web interface available for <application>&app;</application>?</para></question>
+ <answer><para>No</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_software_security">
+ <question><para>How can I provide security for <application>&app;</application> data using CFS, etc.)</para></question>
+ <answer><para>Unanswered</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_software_contribute">
+ <question><para>How can I contribute to the <application>&app;</application> project?</para></question>
+ <answer><para>We’re working on a more formal process, but for now you should subscribe to the mailing list at <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-user">http://lists.gnucash.org/mailman/listinfo/gnucash-user</ulink> and <ulink url="http://lists.gnucash.org/mailman/listinfo/gnucash-devel">http://lists.gnucash.org/mailman/listinfo/gnucash-devel</ulink> and discuss what you can contribute with the participants on the lists. Please be aware that <application>&app;</application> is a large body of code written in C and Scheme (see the FAQ above, <quote>Why is <application>&app;</application> written in C?</quote> if you want to know why). If these are languages that you are not willing to work with, consider contributing in other ways.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_software_bugs">
+ <question><para>I think I found a bug. How do I report it?</para></question>
+ <answer><para>First of all, try to verify that it is indeed a bug and that it has not been reported before. Search the mail list archives (see FAQ above). Then search the <ulink url="http://bugs.gnucash.org">&app; Bugzilla</ulink> database.</para>
+ <para>If you feel you have indeed found a bug, you can then report it at <ulink url="http://bugs.gnucash.org/enter_bug.cgi?product=&app;"></ulink>. Please bear in mind to report your bug as verbosely as possible. The trick here is to learn how to give the best information to the programmers about how to reproduce bugs. A Programmer will usually only be able to fix a bug they can see, if you can’t make the programmer see your bug, it won’t get fixed!</para></answer>
+ </qandaentry>
+
+ </qandadiv>
+ <qandadiv id="appendixb_using">
<title>Using <application>&app;</application></title>
- <sect2 id="appendixb_using_moveAtoB">
- <title>Q: How can I move the transactions from account <quote>A</quote> into account <quote>B</quote>, thus combining them?</title>
- <para>A: At present, <application>&app;</application> does not offer a way to move groups of splits from one account to another. You will need to move them one at a time. Open the register for account <quote>A</quote> and select the pulldown menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Transaction Journal</guimenuitem></menuchoice> to expose all the splits. For every split where the <quote>Account</quote> field shows account <quote>A</quote> reset it to account <quote>B</quote>. To do this quickly and safely, first use <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> to copy the destination account name (<quote>account B</quote>) to the clipboard. Then highlight each reference to account <quote>A</quote> by double clicking on it and use <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> to paste the destination account name. Pressing <keycap function="enter">Enter</keycap> after each paste, silently moves the transaction out of the register.</para>
- <para>Be careful! If you inadvertently set the <quote>Account</quote> field to an unintended location, you will need to search through all your accounts to find the lost transaction to correct your mistake.</para>
- </sect2>
-
- <sect2 id="appendixb_using_merge2files">
- <title>Q: Is it possible to merge two <application>&app;</application> files?</title>
- <para>A: At present this is not possible.</para>
- </sect2>
-
- <sect2 id="appendixb_using_SaveAcctTemplate">
- <title>Q: How can I save a template of my account structure?</title>
- <para>A: This is available from the menu: <menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu><guimenuitem>Export Accounts</guimenuitem></menuchoice></para>
- </sect2>
- <sect2 id="appendixb_using_ListAll">
- <title>Q: When I search for customers (or anything else for that matter), how can I return a list of everything?</title>
- <para>A: Enter a search criteria of <guilabel>matches regex</guilabel>, and place a single dot <quote>.</quote> in the text field area. Then, click <guibutton>Find</guibutton>. The regular expression <quote>.</quote> means to match anything.</para>
- </sect2>
- <sect2 id="appendixb_using_Dates">
- <title>Q: How can I record a transaction on different dates (actual date and bank date)?</title>
- <para>A: You record the transaction on the date you write the check or initiate the transaction. When it <quote>clears</quote> the bank, you can click in the <quote>Reconciled</quote> field to <quote>clear</quote> the transaction (change the <quote>n</quote>on-reconciled to <quote>c</quote>leared).</para>
- </sect2>
- </sect1>
- <sect1 id="appendixb_accounting">
+ <qandaentry id="appendixb_using_moveAtoB">
+ <question><para>How can I move the transactions from account <quote>A</quote> into account <quote>B</quote>, thus combining them?</para></question>
+ <answer><para>At present, <application>&app;</application> does not offer a way to move groups of splits from one account to another. You will need to move them one at a time. Open the register for account <quote>A</quote> and select the pulldown menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Transaction Journal</guimenuitem></menuchoice> to expose all the splits. For every split where the <quote>Account</quote> field shows account <quote>A</quote> reset it to account <quote>B</quote>. To do this quickly and safely, first use <keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> to copy the destination account name (<quote>account B</quote>) to the clipboard. Then highlight each reference to account <quote>A</quote> by double clicking on it and use <keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo> to paste the destination account name. Pressing <keycap function="enter">Enter</keycap> after each paste, silently moves the transaction out of the register.</para>
+ <caution><para>If you inadvertently set the <quote>Account</quote> field to an unintended location, you will need to search through all your accounts to find the lost transaction to correct your mistake.</para></caution></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_using_merge2files">
+ <question><para>Is it possible to merge two <application>&app;</application> files?</para></question>
+ <answer><para>At present this is not possible.</para></answer>
+ </qandaentry>
+
+ <qandaentry id="appendixb_using_SaveAcctTemplate">
+ <question><para>How can I save a template of my account structure?</para></question>
+ <answer><para>This is available from the menu: <menuchoice><guimenu>File</guimenu><guisubmenu>Export</guisubmenu><guimenuitem>Export Accounts</guimenuitem></menuchoice></para></answer>
+ </qandaentry>
+ <qandaentry id="appendixb_using_ListAll">
+ <question><para>When I search for customers (or anything else for that matter), how can I return a list of everything?</para></question>
+ <answer><para>Enter a search criteria of <guilabel>matches regex</guilabel>, and place a single dot <quote>.</quote> in the text field area. Then, click <guibutton>Find</guibutton>. The regular expression <quote>.</quote> means to match anything.</para></answer>
+ </qandaentry>
+ <qandaentry id="appendixb_using_Dates">
+ <question><para>How can I record a transaction on different dates (actual date and bank date)?</para></question>
+ <answer><para>You record the transaction on the date you write the check or initiate the transaction. When it <quote>clears</quote> the bank, you can click in the <quote>Reconciled</quote> field to <quote>clear</quote> the transaction (change the <quote>n</quote>on-reconciled to <quote>c</quote>leared).</para></answer>
+ </qandaentry>
+ </qandadiv>
+ <qandadiv id="appendixb_accounting">
<title>Accounting</title>
- <sect2 id="appendixb_accounting_Taxes">
- <title>Q: How do I treat taxes? As an account payable or as an expense?</title>
- <para>A: This is a loaded question, and you should really talk to your accountant. How you treat taxes really depends on what kind of taxes they are, and how you WANT to treat them.. In some cases they are expenses, in some cases they are liabilities.</para>
- </sect2>
- </sect1>
- </appendix>
+ <qandaentry id="appendixb_accounting_Taxes">
+ <question><para>How do I treat taxes? As an account payable or as an expense?</para></question>
+ <answer><para>This is a loaded question, and you should really talk to your accountant. How you treat taxes really depends on what kind of taxes they are, and how you WANT to treat them.. In some cases they are expenses, in some cases they are liabilities.</para></answer>
+ </qandaentry>
+ </qandadiv>
+ </qandaset>
+</appendix>
Summary of changes:
docbook/gnc-docbookx.dtd | 1 +
guide/C/appendixb.xml | 233 ++++++++++++++++++++++++-----------------------
2 files changed, 120 insertions(+), 114 deletions(-)
More information about the gnucash-changes
mailing list