[GNC-dev] Git Questions With Documentation

David Cousens davidcousens at bigpond.com
Sat Sep 15 18:12:31 EDT 2018


Main reason I pushed it through to the current Help manual is that I had it completed to slot in there already apart
from a bit of minor debugging. If the current vesion of the guide continues for v3.3 I thought it was worth having it in
the help manual at least. I agree it is really material for the guide. I had a look at your Github repository but I
coudn't see a branch for the new guide and you were 139 commits behind the maint on the Gnucash github, so I figured it
was easier to put it there and you can extract it from there. Changes are in Help_ch_Transactions.xml. I can send you
the code that you can slot into an appropriate position in the guide or formulate it as a pull request.  It is mainly
<sect2 > and <sect3> structures that should slot into an existing chapter structure without any problem. I'll attach the
XML file here as well.

There is one reference to a figure which is missing in the Import QIF section as for some reason i couldn't pull it off
the wiki and a few points where a couple of pics of the import matcher would make things even clearer. I'll put together
a patch for that. Probably worth waiting for the new guide to do that.

David Cousens

On Fri, 2018-09-14 at 22:51 -0400, David T. wrote:
> David,
> A couple of points.
> Why not put this directly into the new chapter in the Guide, rather than into the Help? This is precisely the kind of
> detailed information that belongs IMHO in the Guide rather than Help. I know it’s not in Maint yet, but it will be
> shortly.
> Next, in the interest of completeness, your list should include *all* import formats, and stub sections for those
> formats later on. Someone else can provide detail later on, but the basic description needs to be complete.
> Otherwise, this looks great. Thanks!
> David T.
> > On Sep 14, 2018, at 9:29 PM, David Cousens <davidcousens at bigpond.com> wrote:
> > 
> > David ,
> > 
> > I have completed the import section as an addition to the Help  manual  CH
> > 6. I have put a pull request to gnucash-docs on Github to incorporate it
> > into maint as the changes for the multiple selection may possibly go into
> > the next release.
> > 
> > Once it has been pulled into the main Github repository as Bug 796856.  I
> > think you will be able to get it by rebasing your repository to the maint
> > branch of the gnucash-docs Github repository. I only know enough git to be
> > dangerous so am not the best source of advice on how exactly to do that at
> > this stage. I am starting to understand what is going on now. I have used
> > git for quite a few years to my own repository but am now getting used to
> > the 3 way operation for code and documentation updates to GnuCash.
> > 
> > David Cousens
> > 
> > 
> > 
> > -----
> > David Cousens
> > --
> > Sent from: http://gnucash.1415818.n4.nabble.com/GnuCash-Dev-f1435356.html
> > _______________________________________________
> > gnucash-devel mailing list
> > gnucash-devel at gnucash.org
> > https://lists.gnucash.org/mailman/listinfo/gnucash-devel
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Help_ch_Transactions.xml
Type: application/xml
Size: 67505 bytes
Desc: not available
URL: <http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20180916/42c1025b/attachment-0001.wsdl>

More information about the gnucash-devel mailing list