diff options
Diffstat (limited to 'doc/manual')
| -rw-r--r-- | doc/manual/LedgerSMB-manual.aux | 246 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.lof | 2 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.log | 880 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.out | 56 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.tex | 231 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.toc | 26 | ||||
| -rw-r--r-- | doc/manual/LedgerSMB-manual.txt | 236 |
7 files changed, 791 insertions, 886 deletions
diff --git a/doc/manual/LedgerSMB-manual.aux b/doc/manual/LedgerSMB-manual.aux index 88bb175a..0d4fbbd6 100644 --- a/doc/manual/LedgerSMB-manual.aux +++ b/doc/manual/LedgerSMB-manual.aux @@ -11,250 +11,10 @@ \global \let \hyper@last\relax \fi +\ifx\rEfLiNK\UnDef\gdef \rEfLiNK#1#2{#2}\fi \select@language{english} \@writefile{toc}{\select@language{english}} \@writefile{lof}{\select@language{english}} \@writefile{lot}{\select@language{english}} -\@writefile{toc}{\contentsline {part}{I\hspace {1em}Ledger-SMB and Business Processes}{7}{part.1}} -\@writefile{toc}{\contentsline {section}{\numberline {1}Introduction to Ledger-SMB}{7}{section.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {1.1}Why Ledger-SMB}{7}{subsection.1.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {1.1.1}Advantages of Ledger-SMB}{7}{subsubsection.1.1.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {1.1.2}Key Features}{7}{subsubsection.1.1.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {1.2}Limitations of Ledger-SMB}{9}{subsection.1.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {1.3}System Requirements of Ledger-SMB}{9}{subsection.1.3}} -\@writefile{toc}{\contentsline {section}{\numberline {2}User Account and Database Administration Basics}{9}{section.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}Companies and Datasets}{10}{subsection.2.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {2.2}How to Create a User}{10}{subsection.2.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {2.3}Permissions}{10}{subsection.2.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {2.4}User Account Types}{10}{subsection.2.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {2.5}Other Features}{10}{subsection.2.5}} -\@writefile{toc}{\contentsline {section}{\numberline {3}Chart of Accounts}{10}{section.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}Introduction to Double Entry Bookkeeping}{11}{subsection.3.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.1}Business Entity}{11}{subsubsection.3.1.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.2}Double Entry}{11}{subsubsection.3.1.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.3}Accounts}{11}{subsubsection.3.1.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.4}Debits and Credits}{12}{subsubsection.3.1.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.5}Accrual}{12}{subsubsection.3.1.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.6}References}{12}{subsubsection.3.1.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}General Guidelines on Numbering Accounts}{13}{subsection.3.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}Adding/Modifying Accounts}{13}{subsection.3.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {3.4}Listing Account Balances and Transactions}{13}{subsection.3.4}} -\@writefile{toc}{\contentsline {section}{\numberline {4}Administration}{14}{section.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.1}Taxes, Defaults, and Preferences}{14}{subsection.4.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.1}Adding A Sales Tax Account}{14}{subsubsection.4.1.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.2}Setting a Sales Tax Amount}{14}{subsubsection.4.1.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.3}Default Account Setup}{14}{subsubsection.4.1.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.4}Currency Setup}{14}{subsubsection.4.1.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.5}Sequence Settings}{14}{subsubsection.4.1.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}Audit Control}{15}{subsection.4.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.1}Explaining transaction reversal}{15}{subsubsection.4.2.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}Close books option}{15}{subsubsection.4.2.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.3}Audit Trails}{15}{subsubsection.4.2.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.3}Departments}{16}{subsection.4.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.3.1}Cost v Profit Centers.}{16}{subsubsection.4.3.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.4}Warehouses}{16}{subsection.4.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.5}Languages}{16}{subsection.4.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.6}Types of Businesses}{16}{subsection.4.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.7}Misc.}{16}{subsection.4.7}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.1}GIFI}{16}{subsubsection.4.7.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.2}SIC}{16}{subsubsection.4.7.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.3}Overview of Template Editing}{17}{subsubsection.4.7.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.7.4}Year-end}{17}{subsubsection.4.7.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {4.8}Options in the ledger-smb.conf}{17}{subsection.4.8}} -\@writefile{toc}{\contentsline {section}{\numberline {5}Goods and Services}{17}{section.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.1}Basic Terms}{18}{subsection.5.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.2}The Price Matrix}{18}{subsection.5.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.3}Pricegroups}{18}{subsection.5.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.4}Groups}{18}{subsection.5.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.5}Labor/Overhead}{18}{subsection.5.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.6}Services}{18}{subsection.5.6}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.6.1}Shipping and Handling as a Service}{18}{subsubsection.5.6.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.7}Parts}{18}{subsection.5.7}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.8}Assemblies and Manufacturing}{19}{subsection.5.8}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.8.1}Stocking Assemblies}{19}{subsubsection.5.8.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.9}Reporting}{19}{subsection.5.9}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.9.1}All Items and Parts Reports}{19}{subsubsection.5.9.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.9.2}Requirements}{19}{subsubsection.5.9.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.9.3}Services and Labor}{19}{subsubsection.5.9.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.9.4}Assemblies}{19}{subsubsection.5.9.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {5.9.5}Groups and Pricegroups}{20}{subsubsection.5.9.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.10}Translations}{20}{subsection.5.10}} -\@writefile{toc}{\contentsline {subsection}{\numberline {5.11}How Cost of Goods Sold is tracked}{20}{subsection.5.11}} -\@writefile{toc}{\contentsline {section}{\numberline {6}AP}{20}{section.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.1}Basic AP Concepts}{20}{subsection.6.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.2}Vendors}{20}{subsection.6.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.3}AP Transactions}{20}{subsection.6.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.4}AP Invoices}{21}{subsection.6.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.4.1}Correcting an AP Invoice}{21}{subsubsection.6.4.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.5}Cash payment And Check Printing}{21}{subsection.6.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.5.1}Rapid Payment Entry Screen}{21}{subsubsection.6.5.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.6}Transaction/Invoice Reporting}{22}{subsection.6.6}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.6.1}Transactions Report}{22}{subsubsection.6.6.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.6.2}Outstanding Report}{22}{subsubsection.6.6.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.6.3}AP Aging Report}{22}{subsubsection.6.6.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.6.4}Tax Paid and Non-taxable Report}{22}{subsubsection.6.6.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {6.7}Vendor Reporting}{22}{subsection.6.7}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.7.1}Vendor Search}{22}{subsubsection.6.7.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {6.7.2}Vendor History}{22}{subsubsection.6.7.2}} -\@writefile{toc}{\contentsline {section}{\numberline {7}AR}{23}{section.7}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.1}Customers}{23}{subsection.7.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {7.1.1}Customer Price Matrix}{23}{subsubsection.7.1.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.2}AR Transactions}{23}{subsection.7.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.3}AR Invoices}{23}{subsection.7.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.4}Cash Receipt}{23}{subsection.7.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {7.4.1}Cash Receipts for multiple customers}{23}{subsubsection.7.4.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.5}AR Transaction Reporting}{23}{subsection.7.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {7.5.1}AR Transactions Report}{24}{subsubsection.7.5.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {7.5.2}AR Aging Report}{24}{subsubsection.7.5.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {7.6}Customer Reporting}{24}{subsection.7.6}} -\@writefile{toc}{\contentsline {section}{\numberline {8}Projects}{24}{section.8}} -\@writefile{toc}{\contentsline {subsection}{\numberline {8.1}Project Basics}{24}{subsection.8.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {8.2}Timecards}{24}{subsection.8.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {8.3}Projects and Invoices}{24}{subsection.8.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {8.4}Reporting}{24}{subsection.8.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {8.4.1}Timecard Reporting}{24}{subsubsection.8.4.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {8.4.2}Project Transaction Reporting}{24}{subsubsection.8.4.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {8.4.3}List of Projects}{25}{subsubsection.8.4.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {8.5}Possibilities for Using Projects}{25}{subsection.8.5}} -\@writefile{toc}{\contentsline {section}{\numberline {9}Quotations and Order Management}{25}{section.9}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.1}Sales Orders}{25}{subsection.9.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.2}Quotations}{25}{subsection.9.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.3}Shipping}{25}{subsection.9.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.4}AR Work Flow}{25}{subsection.9.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.4.1}Service Example}{25}{subsubsection.9.4.1}} -\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces Simple AR Service Invoice Workflow Example}}{26}{figure.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.4.2}Single Warehouse Example}{26}{subsubsection.9.4.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.4.3}Multiple Warehouse Example}{26}{subsubsection.9.4.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.5}Requests for Quotation (RFQ)}{26}{subsection.9.5}} -\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces AR Workflow with Shipping}}{27}{figure.2}} -\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces Complex AR Workflow with Shipping}}{28}{figure.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.6}Purchase Orders}{29}{subsection.9.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.7}Receiving}{29}{subsection.9.7}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.8}AP Work Flow}{29}{subsection.9.8}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.8.1}Bookkeeper entering the received items, order completed in full}{29}{subsubsection.9.8.1}} -\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces Simple AP Workflow}}{29}{figure.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.8.2}Bookkeeper entering received items, order completed in part}{29}{subsubsection.9.8.2}} -\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces AP Workflow with Receiving}}{30}{figure.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.8.3}Receiving staff entering items}{31}{subsubsection.9.8.3}} -\@writefile{lof}{\contentsline {figure}{\numberline {6}{\ignorespaces Complex AP Workflow}}{31}{figure.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.9}Generation and Consolidation}{31}{subsection.9.9}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.9.1}Generation}{31}{subsubsection.9.9.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {9.9.2}Consolidation}{32}{subsubsection.9.9.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.10}Reporting}{32}{subsection.9.10}} -\@writefile{toc}{\contentsline {subsection}{\numberline {9.11}Shipping Module: Transferring Inventory between Warehouses}{32}{subsection.9.11}} -\@writefile{toc}{\contentsline {section}{\numberline {10}HR}{32}{section.10}} -\@writefile{toc}{\contentsline {section}{\numberline {11}POS}{32}{section.11}} -\@writefile{toc}{\contentsline {subsection}{\numberline {11.1}Sales Screen}{32}{subsection.11.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {11.2}Possibilities for Data Entry}{32}{subsection.11.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {11.3}Hardware Support}{33}{subsection.11.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {11.4}Reports}{33}{subsection.11.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {11.4.1}Open Invoices}{33}{subsubsection.11.4.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {11.4.2}Receipts}{33}{subsubsection.11.4.2}} -\@writefile{toc}{\contentsline {section}{\numberline {12}General Ledger}{33}{section.12}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.1}GL Basics}{33}{subsection.12.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {12.1.1}Paper-based accounting systems and the GL}{33}{subsubsection.12.1.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {12.1.2}Double Entry Examples on Paper}{34}{subsubsection.12.1.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {12.1.3}The GL in Ledger-SMB}{34}{subsubsection.12.1.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.2}Cash Transfer}{34}{subsection.12.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.3}GL Transactions}{35}{subsection.12.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.4}Payroll as a GL transaction}{35}{subsection.12.4}} -\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces Payroll as a GL Transaction (Purely fictitious numbers)}}{35}{figure.7}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.5}Reconciliation}{35}{subsection.12.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.6}Reports}{36}{subsection.12.6}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {12.6.1}GL as access to almost everything else}{36}{subsubsection.12.6.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {12.7}Using GL entries for Depreciation}{36}{subsection.12.7}} -\@writefile{toc}{\contentsline {section}{\numberline {13}Recurring Transactions}{37}{section.13}} -\@writefile{toc}{\contentsline {section}{\numberline {14}Financial Statements and Reports}{37}{section.14}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.1}Cash v. Accrual Basis}{37}{subsection.14.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.2}Viewing the Chart of Accounts and Transactions}{37}{subsection.14.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.3}Trial Balance}{37}{subsection.14.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.3.1}The Paper-based function of a Trial Balance}{37}{subsubsection.14.3.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.3.2}Running the Trial Balance Report}{38}{subsubsection.14.3.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.3.3}What if the Trial Balance doesn't Balance?}{38}{subsubsection.14.3.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.3.4}Trial Balance as a Summary of Account Activity}{38}{subsubsection.14.3.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.3.5}Trial Balance as a Budget Planning Tool}{38}{subsubsection.14.3.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.4}Income Statement}{38}{subsection.14.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {14.4.1}Uses of an Income Statement}{39}{subsubsection.14.4.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.5}Balance Sheet}{39}{subsection.14.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.6}What if the Balance Sheet doesn't balance?}{39}{subsection.14.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {14.7}No Statement of Owner Equity?}{39}{subsection.14.7}} -\@writefile{toc}{\contentsline {section}{\numberline {15}The Template System}{40}{section.15}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.1}Text Templates}{40}{subsection.15.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.2}HTML Templates}{40}{subsection.15.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.3}\LaTeX {}\ Templates}{41}{subsection.15.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {15.3.1}What is \LaTeX {}\ ?}{42}{subsubsection.15.3.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {15.3.2}Using L\kern -.1667em\lower .25em\hbox {Y}\kern -.125emX\spacefactor \@m {} to Edit \LaTeX {}\ Templates}{42}{subsubsection.15.3.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.4}Customizing Logos}{42}{subsection.15.4}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.5}How are They Stored in the Filesystem?}{42}{subsection.15.5}} -\@writefile{toc}{\contentsline {subsection}{\numberline {15.6}Upgrade Issues}{42}{subsection.15.6}} -\@writefile{toc}{\contentsline {section}{\numberline {16}An Introduction to the CLI}{43}{section.16}} -\@writefile{toc}{\contentsline {subsection}{\numberline {16.1}Conventions}{43}{subsection.16.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {16.2}Preliminaries}{43}{subsection.16.2}} -\@writefile{toc}{\contentsline {subsection}{\numberline {16.3}First Script: lsmb01-cli-example.sh}{43}{subsection.16.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {16.3.1}Script 1 (Bash)}{44}{subsubsection.16.3.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {16.4}Second Script: lsmb02-cli-example.pl}{45}{subsection.16.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {16.4.1}Script 2 (Perl)}{45}{subsubsection.16.4.1}} -\@writefile{toc}{\contentsline {part}{II\hspace {1em}Technical Overview}{49}{part.2}} -\@writefile{toc}{\contentsline {section}{\numberline {17}Basic Architecture}{49}{section.17}} -\@writefile{toc}{\contentsline {subsection}{\numberline {17.1}The Software Stack}{49}{subsection.17.1}} -\newlabel{fig-sl-stack}{{17.1}{49}{The Software Stack\relax }{subsection.17.1}{}} -\@writefile{lof}{\contentsline {figure}{\numberline {8}{\ignorespaces The Ledger-SMB software stack in a Typical Implementation}}{49}{figure.8}} -\@writefile{toc}{\contentsline {subsection}{\numberline {17.2}Capacity Planning}{50}{subsection.17.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {17.2.1}Scalability Strategies}{50}{subsubsection.17.2.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {17.2.2}Database Maintenance}{50}{subsubsection.17.2.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {17.2.3}Known issues}{51}{subsubsection.17.2.3}} -\@writefile{toc}{\contentsline {section}{\numberline {18}Customization Possibilities}{51}{section.18}} -\@writefile{toc}{\contentsline {subsection}{\numberline {18.1}Brief Guide to the Source Code}{51}{subsection.18.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {18.2}Data Entry Screens}{52}{subsection.18.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {18.2.1}Examples}{52}{subsubsection.18.2.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {18.3}Extensions}{52}{subsection.18.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {18.3.1}Examples}{52}{subsubsection.18.3.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {18.4}Templates}{52}{subsection.18.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {18.4.1}Examples}{52}{subsubsection.18.4.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {18.5}Reports}{52}{subsection.18.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {18.5.1}Examples}{53}{subsubsection.18.5.1}} -\@writefile{toc}{\contentsline {section}{\numberline {19}Integration Possibilities}{53}{section.19}} -\@writefile{toc}{\contentsline {subsection}{\numberline {19.1}Reporting Tools}{53}{subsection.19.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.1.1}Examples}{53}{subsubsection.19.1.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {19.2}Line of Business Tools on PostgreSQL}{53}{subsection.19.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.2.1}Known Issues}{53}{subsubsection.19.2.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.2.2}Strategies}{53}{subsubsection.19.2.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.2.3}Examples}{54}{subsubsection.19.2.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {19.3}Line of Business Tools on other RDBMS's}{54}{subsection.19.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.3.1}Strategies}{54}{subsubsection.19.3.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {19.3.2}Integration Products and Open Source Projects}{54}{subsubsection.19.3.2}} -\@writefile{toc}{\contentsline {section}{\numberline {20}Customization Guide}{54}{section.20}} -\@writefile{toc}{\contentsline {subsection}{\numberline {20.1}General Information}{54}{subsection.20.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {20.2}Customizing Templates}{55}{subsection.20.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.1}Page Breaks in \LaTeX {}}{55}{subsubsection.20.2.1}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.2}Conditionals}{55}{subsubsection.20.2.2}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.3}Loops}{55}{subsubsection.20.2.3}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.4}File Inclusion}{56}{subsubsection.20.2.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.5}Cross-referencing and multiple passes of \LaTeX {}}{56}{subsubsection.20.2.5}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.2.6}Variable Substitution}{56}{subsubsection.20.2.6}} -\@writefile{toc}{\contentsline {subsection}{\numberline {20.3}Customizing Forms}{56}{subsection.20.3}} -\@writefile{toc}{\contentsline {subsection}{\numberline {20.4}Customizing Modules}{57}{subsection.20.4}} -\@writefile{toc}{\contentsline {subsubsection}{\numberline {20.4.1}Database Access}{57}{subsubsection.20.4.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {20.5}CLI Examples}{57}{subsection.20.5}} -\@writefile{toc}{\contentsline {part}{III\hspace {1em}Appendix}{58}{part.3}} -\@writefile{toc}{\contentsline {section}{\numberline {A}Where to Go for More Information}{58}{section.A}} -\@writefile{toc}{\contentsline {section}{\numberline {B}Quick Tips}{58}{section.B}} -\@writefile{toc}{\contentsline {subsection}{\numberline {B.1}Understanding Shipping Addresses and Carriers}{58}{subsection.B.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {B.2}Handling bad debts}{58}{subsection.B.2}} -\@writefile{toc}{\contentsline {section}{\numberline {C}Step by Steps for Vertical Markets}{58}{section.C}} -\@writefile{toc}{\contentsline {subsection}{\numberline {C.1}Common Installation Errors}{58}{subsection.C.1}} -\@writefile{toc}{\contentsline {subsection}{\numberline {C.2}Retail With Light Manufacturing}{58}{subsection.C.2}} -\@writefile{toc}{\contentsline {section}{\numberline {D}Glossary}{60}{section.D}} -\@writefile{toc}{\contentsline {section}{\numberline {E}GNU Free Documentation License}{61}{section.E}} -\newlabel{fdl}{{E}{61}{GNU Free Documentation License\relax }{section.E}{}} -\@writefile{toc}{\contentsline {subsection}{1. APPLICABILITY AND DEFINITIONS}{61}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{2. VERBATIM COPYING}{62}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{3. COPYING IN QUANTITY}{62}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{4. MODIFICATIONS}{63}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{5. COMBINING DOCUMENTS}{64}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{6. COLLECTIONS OF DOCUMENTS}{65}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{7. AGGREGATION WITH INDEPENDENT WORKS}{65}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{8. TRANSLATION}{65}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{9. TERMINATION}{65}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{10. FUTURE REVISIONS OF THIS LICENSE}{65}{section*.3}} -\@writefile{toc}{\contentsline {subsection}{ADDENDUM: How to use this License for your documents}{66}{section*.3}} +\newlabel{fig-sl-stack}{{\rEfLiNK{x1-17700017.1}{\csname :autoref\endcsname{figure}17.1}}{\rEfLiNK{x1-17700017.1}{\csname :autoref\endcsname{figure}80}}{}{}{}} +\newlabel{fdl}{{\rEfLiNK{x1-224000E}{\csname :autoref\endcsname{section}E}}{\rEfLiNK{x1-224000E}{\csname :autoref\endcsname{section}95}}{}{}{}} diff --git a/doc/manual/LedgerSMB-manual.lof b/doc/manual/LedgerSMB-manual.lof index e9f0cadf..681898c7 100644 --- a/doc/manual/LedgerSMB-manual.lof +++ b/doc/manual/LedgerSMB-manual.lof @@ -6,4 +6,4 @@ \contentsline {figure}{\numberline {5}{\ignorespaces AP Workflow with Receiving}}{30}{figure.5} \contentsline {figure}{\numberline {6}{\ignorespaces Complex AP Workflow}}{31}{figure.6} \contentsline {figure}{\numberline {7}{\ignorespaces Payroll as a GL Transaction (Purely fictitious numbers)}}{35}{figure.7} -\contentsline {figure}{\numberline {8}{\ignorespaces The Ledger-SMB software stack in a Typical Implementation}}{49}{figure.8} +\contentsline {figure}{\numberline {8}{\ignorespaces The LedgerSMB software stack in a Typical Implementation}}{49}{figure.8} diff --git a/doc/manual/LedgerSMB-manual.log b/doc/manual/LedgerSMB-manual.log index c93a0c11..ffad4a0c 100644 --- a/doc/manual/LedgerSMB-manual.log +++ b/doc/manual/LedgerSMB-manual.log @@ -1,17 +1,18 @@ -This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) (format=pdflatex 2007.1.7) 13 JUL 2007 15:51 +This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) (format=latex 2007.5.18) 21 SEP 2007 15:22 entering extended mode -**LedgerSMB-manual.tex + %&-line parsing enabled. +**\makeatletter\def\HCode{\futurelet\HCode\HChar}\def\HChar{\ifx"\HCode\def\HCo +de"##1"{\Link##1}\expandafter\HCode\else\expandafter\Link\fi}\def\Link#1.a.b.c. +{\g@addto@macro\@documentclasshook{\RequirePackage[#1,html]{tex4ht}}\let\HCode\ +documentstyle\def\documentstyle{\let\documentstyle\HCode\expandafter\def\csname + tex4ht\endcsname{#1,html}\def\HCode####1{\documentstyle[tex4ht,}\@ifnextchar[{ +\HCode}{\documentstyle[tex4ht]}}}\makeatother\HCode .a.b.c.\input LedgerSMB-ma +nual.tex (./LedgerSMB-manual.tex -LaTeX2e <2003/12/01> -Babel <v3.8d> and hyphenation patterns for american, french, german, ngerman, b -ahasa, basque, bulgarian, catalan, croatian, czech, danish, dutch, esperanto, e -stonian, finnish, greek, icelandic, irish, italian, latin, magyar, norsk, polis -h, portuges, romanian, russian, serbian, slovak, slovene, spanish, swedish, tur -kish, ukrainian, nohyphenation, loaded. -(/usr/share/texmf/tex/latex/base/article.cls -Document Class: article 2004/02/16 v1.4f Standard LaTeX document class -(/usr/share/texmf/tex/latex/base/size10.clo -File: size10.clo 2004/02/16 v1.4f Standard LaTeX file (size option) +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/article.cls +Document Class: article 2005/09/16 v1.4f Standard LaTeX document class +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/size10.clo +File: size10.clo 2005/09/16 v1.4f Standard LaTeX file (size option) ) \c@part=\count79 \c@section=\count80 @@ -25,120 +26,128 @@ File: size10.clo 2004/02/16 v1.4f Standard LaTeX file (size option) \belowcaptionskip=\skip42 \bibindent=\dimen102 ) -(/usr/share/texmf/tex/latex/base/fontenc.sty -Package: fontenc 2004/02/22 v1.99f Standard LaTeX package +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/tex4ht.sty +version 2006-10-28-15:32 +Package: tex4ht +-------------------------------------- +--- Note --- for _ at preamble, use the command line option `early_' +-------------------------------------- +-------------------------------------- +--- Note --- for ^ at preamble, use the command line option `early^' +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/usepackage.4ht +version 2007-01-03-21:02 +) +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/fontenc.sty +Package: fontenc 2005/09/27 v1.99g Standard LaTeX package -(/usr/share/texmf/tex/latex/base/t1enc.def -File: t1enc.def 2004/02/22 v1.99f Standard LaTeX file +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/t1enc.def +File: t1enc.def 2005/09/27 v1.99g Standard LaTeX file LaTeX Font Info: Redeclaring font encoding T1 on input line 43. )) -(/usr/share/texmf/tex/latex/base/inputenc.sty -Package: inputenc 2004/02/05 v1.0d Input encoding file +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/inputenc.sty +Package: inputenc 2006/05/05 v1.1b Input encoding file +\inpenc@prehook=\toks14 +\inpenc@posthook=\toks15 -(/usr/share/texmf/tex/latex/base/latin1.def -File: latin1.def 2004/02/05 v1.0d Input encoding file +(/usr/local/texlive/2007/texmf-dist/tex/latex/base/latin1.def +File: latin1.def 2006/05/05 v1.1b Input encoding file )) -(/usr/share/texmf/tex/latex/url/url.sty +(/usr/local/texlive/2007/texmf-dist/tex/latex/ltxmisc/url.sty \Urlmuskip=\muskip10 -Package: url 2004/03/15 ver 3.1 Verb mode for urls, etc. +Package: url 2005/06/27 ver 3.2 Verb mode for urls, etc. ) (./metatron.sty Package: metatron -(/usr/share/texmf/tex/latex/psnfss/palatino.sty -Package: palatino 2004/09/15 PSNFSS-v9.2 (SPQR) +(/usr/local/texlive/2007/texmf-dist/tex/latex/psnfss/palatino.sty +Package: palatino 2005/04/12 PSNFSS-v9.2a (SPQR) ) -(/usr/share/texmf/tex/latex/graphics/color.sty -Package: color 1999/02/16 v1.0i Standard LaTeX Color (DPC) +(/usr/local/texlive/2007/texmf-dist/tex/latex/graphics/color.sty +Package: color 2005/11/14 v1.0j Standard LaTeX Color (DPC) -(/usr/share/texmf/tex/latex/graphics/color.cfg -File: color.cfg 2005/02/03 v1.3 color configuration of teTeX/TeXLive +(/usr/local/texlive/2007/texmf/tex/latex/config/color.cfg +File: color.cfg 2007/01/18 v1.5 color configuration of teTeX/TeXLive ) -Package color Info: Driver file: pdftex.def on input line 125. +Package color Info: Driver file: dvips.def on input line 130. -(/usr/share/texmf/tex/latex/graphics/pdftex.def -File: pdftex.def 2002/06/19 v0.03k graphics/color for pdftex -\Gread@gobject=\count87 +(/usr/local/texlive/2007/texmf-dist/tex/latex/graphics/dvips.def +File: dvips.def 1999/02/16 v3.0i Driver-dependant file (DPC,SPQR) +) +(/usr/local/texlive/2007/texmf-dist/tex/latex/graphics/dvipsnam.def +File: dvipsnam.def 1999/02/16 v3.0i Driver-dependant file (DPC,SPQR) )) -(/usr/share/texmf/tex/latex/hyperref/hyperref.sty -Package: hyperref 2003/11/30 v6.74m Hypertext links for LaTeX +(/usr/local/texlive/2007/texmf-dist/tex/latex/hyperref/hyperref.sty +Package: hyperref 2007/02/07 v6.75r Hypertext links for LaTeX -(/usr/share/texmf/tex/latex/graphics/keyval.sty +(/usr/local/texlive/2007/texmf-dist/tex/latex/graphics/keyval.sty Package: keyval 1999/03/16 v1.13 key=value parser (DPC) -\KV@toks@=\toks14 +\KV@toks@=\toks16 ) \@linkdim=\dimen103 -\Hy@linkcounter=\count88 -\Hy@pagecounter=\count89 +\Hy@linkcounter=\count87 +\Hy@pagecounter=\count88 -(/usr/share/texmf/tex/latex/hyperref/pd1enc.def -File: pd1enc.def 2003/11/30 v6.74m Hyperref: PDFDocEncoding definition (HO) +(/usr/local/texlive/2007/texmf-dist/tex/latex/hyperref/pd1enc.def +File: pd1enc.def 2007/02/07 v6.75r Hyperref: PDFDocEncoding definition (HO) +) +(/usr/local/texlive/2007/texmf/tex/latex/config/hyperref.cfg +File: hyperref.cfg 2002/06/06 v1.2 hyperref configuration of TeXLive ) -(/usr/share/texmf/tex/latex/hyperref/hyperref.cfg -File: hyperref.cfg 2002/06/06 v1.2 hyperref configuration of TeXLive and teTeX +(/usr/local/texlive/2007/texmf-dist/tex/latex/oberdiek/kvoptions.sty +Package: kvoptions 2006/08/22 v2.4 Connects package keyval with LaTeX options ( +HO) ) -Package hyperref Info: Option `colorlinks' set `true' on input line 1830. -Package hyperref Info: Hyper figures OFF on input line 1880. -Package hyperref Info: Link nesting OFF on input line 1885. -Package hyperref Info: Hyper index ON on input line 1888. -Package hyperref Info: Plain pages ON on input line 1893. -Package hyperref Info: Backreferencing OFF on input line 1900. +Package hyperref Info: Option `colorlinks' set `true' on input line 2238. +Package hyperref Info: Option `colorlinks' set `true' on input line 2238. +Package hyperref Info: Hyper figures OFF on input line 2288. +Package hyperref Info: Link nesting OFF on input line 2293. +Package hyperref Info: Hyper index ON on input line 2296. +Package hyperref Info: Plain pages OFF on input line 2303. +Package hyperref Info: Backreferencing OFF on input line 2308. Implicit mode ON; LaTeX internals redefined -Package hyperref Info: Bookmarks ON on input line 2004. -LaTeX Info: Redefining \url on input line 2143. -\Fld@menulength=\count90 +Package hyperref Info: Bookmarks ON on input line 2444. +LaTeX Info: Redefining \url on input line 2599. +\Fld@menulength=\count89 \Field@Width=\dimen104 \Fld@charsize=\dimen105 -\Choice@toks=\toks15 -\Field@toks=\toks16 -Package hyperref Info: Hyper figures OFF on input line 2618. -Package hyperref Info: Link nesting OFF on input line 2623. -Package hyperref Info: Hyper index ON on input line 2626. -Package hyperref Info: backreferencing OFF on input line 2633. -Package hyperref Info: Link coloring ON on input line 2636. -\c@Item=\count91 -\c@Hfootnote=\count92 -) -*hyperref using default driver hpdftex* -(/usr/share/texmf/tex/latex/hyperref/hpdftex.def -File: hpdftex.def 2003/11/30 v6.74m Hyperref driver for pdfTeX - -(/usr/share/texmf/tex/latex/psnfss/pifont.sty -Package: pifont 2004/09/15 PSNFSS-v9.2 Pi font support (SPQR) -LaTeX Font Info: Try loading font information for U+pzd on input line 63. - -(/usr/share/texmf/tex/latex/psnfss/upzd.fd -File: upzd.fd 2001/06/04 font definitions for U/pzd. -) -LaTeX Font Info: Try loading font information for U+psy on input line 64. - -(/usr/share/texmf/tex/latex/psnfss/upsy.fd -File: upsy.fd 2001/06/04 font definitions for U/psy. -)) -\Fld@listcount=\count93 -\@outlinefile=\write3 +\Choice@toks=\toks17 +\Field@toks=\toks18 +Package hyperref Info: Hyper figures OFF on input line 3102. +Package hyperref Info: Link nesting OFF on input line 3107. +Package hyperref Info: Hyper index ON on input line 3110. +Package hyperref Info: backreferencing OFF on input line 3117. +Package hyperref Info: Link coloring ON on input line 3120. +\Hy@abspage=\count90 +Hyperref stopped early ) -(/usr/share/texmf/tex/latex/geometry/geometry.sty +*hyperref using driver htex4ht* +(/usr/local/texlive/2007/texmf-dist/tex/latex/hyperref/htex4ht.def +File: htex4ht.def 2007/02/07 v6.75r Hyperref driver for TeX4ht + +hyperref tex4ht: tex4ht already loaded +) (/usr/local/texlive/2007/texmf-dist/tex/latex/geometry/geometry.sty Package: geometry 2002/07/08 v3.2 Page Geometry -\Gm@cnth=\count94 -\Gm@cntv=\count95 -\c@Gm@tempcnt=\count96 +\Gm@cnth=\count91 +\Gm@cntv=\count92 +\c@Gm@tempcnt=\count93 \Gm@bindingoffset=\dimen106 \Gm@wd@mp=\dimen107 \Gm@odd@mp=\dimen108 \Gm@even@mp=\dimen109 -\Gm@dimlist=\toks17 +\Gm@dimlist=\toks19 -(/usr/share/texmf/tex/latex/geometry/geometry.cfg))) -(/usr/share/texmf/tex/generic/babel/babel.sty -Package: babel 2004/11/20 v3.8d The Babel package +(/usr/local/texlive/2007/texmf-dist/tex/xelatex/xetexconfig/geometry.cfg))) +(/usr/local/texlive/2007/texmf-dist/tex/generic/babel/babel.sty +Package: babel 2005/11/23 v3.8h The Babel package -(/usr/share/texmf/tex/generic/babel/english.ldf -Language: english 2004/06/14 v3.3o English support from the babel system +(/usr/local/texlive/2007/texmf-dist/tex/generic/babel/english.ldf +Language: english 2005/03/30 v3.3o English support from the babel system -(/usr/share/texmf/tex/generic/babel/babel.def -File: babel.def 2004/11/20 v3.8d Babel common definitions -\babel@savecnt=\count97 +(/usr/local/texlive/2007/texmf-dist/tex/generic/babel/babel.def +File: babel.def 2005/11/23 v3.8h Babel common definitions +\babel@savecnt=\count94 \U@D=\dimen110 ) \l@british = a dialect from \language\l@english @@ -146,7 +155,328 @@ File: babel.def 2004/11/20 v3.8d Babel common definitions \l@canadian = a dialect from \language\l@american \l@australian = a dialect from \language\l@british \l@newzealand = a dialect from \language\l@british -)) (./LedgerSMB-manual.aux) +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/tex4ht.4ht +version 2006-02-22-12:25 +-------------------------------------- +--- Note --- for additional information, use the command line option `info' +-------------------------------------- + +:::::::::::::::::::::::::::::::::::::::::: + TeX4ht info is available in the log file +:::::::::::::::::::::::::::::::::::::::::: +) (/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/tex4ht.sty +version 2006-10-28-15:32 + +--- needs --- tex4ht LedgerSMB-manual --- +\tmp:cnt=\count95 +\openout15 = `LedgerSMB-manual.tmp'. + +(./LedgerSMB-manual.tmp) +\tmp:toks=\toks20 +\tmp:dim=\skip43 +-------------------------------------- +--- Note --- for XML code, use the command line option `xml' or `xhtml' +-------------------------------------- + (./LedgerSMB-manual.xref) +\:refout=\write3 +\openout3 = `LedgerSMB-manual.xref'. + + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- to remove the DOCTYPE declaration use the command line option `no- +DOCTYPE' +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +) +-------------------------------------- +--- Note --- for marking of the base font, use the command line option `fonts+' + +-------------------------------------- +-------------------------------------- +--- Note --- for non active _, use the command line option `no_' +-------------------------------------- +-------------------------------------- +--- Note --- for _ of catcode 13, use the command line option `_13' +-------------------------------------- +-------------------------------------- +--- Note --- for non active ^, use the command line option `no^' +-------------------------------------- +-------------------------------------- +--- Note --- for ^ of catcode 13, use the command line option `^13' +-------------------------------------- + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- for alternative charset, use the command line option `charset=...' + +-------------------------------------- +-------------------------------------- +--- Note --- to ignore CSS font decoration, use the `NoFonts' command line opti +on +-------------------------------------- +-------------------------------------- +--- Note --- for jpg bitmaps of pictures, use the `jpg' command line option. (C +haracter bitmaps are controled only by `g' records of tex4ht.env and `-g' switc +hes of tex4ht.c) +-------------------------------------- +-------------------------------------- +--- Note --- for gif bitmaps of pictures, use the `gif' command line option. (C +haracter bitmaps are controled only by `g' records of tex4ht.env and `-g' switc +hes of tex4ht.c) +-------------------------------------- +-------------------------------------- +--- Note --- for content and toc in 2 frames, use the command line option `fram +es' +-------------------------------------- +-------------------------------------- +--- Note --- for content, toc, and footnotes in 3 frames, use the command line +option `frames-fn' +-------------------------------------- +-------------------------------------- +--- Note --- for file extension name xht, use the command line option `xht' +-------------------------------------- +TeX4ht package options: html +-------------------------------------- +--- Note --- for inline CSS code, use the command line option `css-in' +-------------------------------------- +-------------------------------------- +--- Note --- for pop ups on mouse over, use the command line option `mouseover' + +-------------------------------------- +-------------------------------------- +--- Note --- for addressing images in a subdirectory, use the command line opti +on `imgdir:.../' +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +) +\:tokwrite=\toks21 +\:tokpage=\toks22 +-------------------------------------- +--- Note --- for back links to toc, use the command line option `sections+' +-------------------------------------- +-------------------------------------- +--- Note --- for linear crosslinks of pages, use the command line option `next' + +-------------------------------------- +\openout15 = `LedgerSMB-manual.4ct'. + +\:tocout=\write4 +\openout4 = `LedgerSMB-manual.4tc'. + + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/latex.4ht +version 2007-01-03-21:02 +-------------------------------------- +--- Note --- for links into captions, instead of float heads, use the command l +ine option `refcaption' +-------------------------------------- + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- for enumerated list elements li's with value attributes, use the c +ommand line option `li-' +-------------------------------------- +-------------------------------------- +--- Note --- for CSS2 code, use the command line option `css2' +-------------------------------------- +-------------------------------------- +--- Note --- for pictorial tabular, use the command line option `pic-tabular' +-------------------------------------- +-------------------------------------- +--- Note --- for bitmap fbox'es, use the command line option `pic-fbox' +-------------------------------------- +-------------------------------------- +--- Note --- for bitmap framebox'es, use the command line option `pic-framebox' + +-------------------------------------- +-------------------------------------- +--- Note --- for inline footnotes use command line option `fn-in' +-------------------------------------- +-------------------------------------- +--- Note --- for a JavaHelp output format, use the command line option `javahel +p' +-------------------------------------- +-------------------------------------- +--- Note --- for tracing of latex font commands, use the command line option `f +onts' +-------------------------------------- +-------------------------------------- +--- Note --- for width specifications of tabular p entries, use the `p-width' c +ommand line option or a configuration similar to \Configure{HColWidth}{\HCode{ +style="width:\HColWidth"}} +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- for pictorial eqnarray, use the command line option `pic-eqnarray' + +-------------------------------------- +-------------------------------------- +--- Note --- for pictorial array, use the command line option `pic-array' +-------------------------------------- +-------------------------------------- +--- Note --- for pictorial $...$ environments, use the command line option `pic +-m' (not recommended!!) +-------------------------------------- +-------------------------------------- +--- Note --- for pictorial $...$ and $$...$$ environments with latex alt, use t +he command line option `pic-m+' (not safe!!) +-------------------------------------- +-------------------------------------- +--- Note --- for pictorial array, use the command line option `pic-array' +-------------------------------------- +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/fontmath.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/article.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- for automatic sectioning pagination, use the command line option ` +1', `2', `3', '4', '5', '6', or '7' +-------------------------------------- +-------------------------------------- +--- Note --- for files named derived from section titles, use the command line +option `sec-filename' +-------------------------------------- +-------------------------------------- +--- Note --- for i-columns index, use the command line option `index=i' (e.g., +index=2) +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/inputenc.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/latin1.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/url.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +-------------------------------------- +--- Note --- for URL encoding within href use the command line option `url-enc' + +-------------------------------------- +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/color.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/dvips.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/dvipsnam.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/latex/graphics/dvipsnam.def) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/hyperref.4ht +version 2007-01-03-21:02 + +l.291 --- TeX4ht warning --- \href of hyperref.sty introduces the prefix `file: +' to prefix-free references. The command \hyperlinkfileprefix{...} may be used +for changing the prefix (probably \hyperlinkfileprefix{}). --- +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/pd1enc.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/babel.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/english.4ht +version 2007-01-03-21:02 + +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4.4ht +version 2007-01-02-13:00 +) +(/usr/local/texlive/2007/texmf-dist/tex/generic/tex4ht/html4-math.4ht +version 2007-01-02-13:00 +)) +(./LedgerSMB-manual.aux) \openout1 = `LedgerSMB-manual.aux'. LaTeX Font Info: Checking defaults for OML/cmm/m/it on input line 32. @@ -165,54 +495,12 @@ LaTeX Font Info: Checking defaults for PD1/pdf/m/n on input line 32. LaTeX Font Info: ... okay on input line 32. LaTeX Font Info: Try loading font information for T1+ppl on input line 32. -(/usr/share/texmf/tex/latex/psnfss/t1ppl.fd +(/usr/local/texlive/2007/texmf-dist/tex/latex/psnfss/t1ppl.fd File: t1ppl.fd 2001/06/04 font definitions for T1/ppl. ) -(/usr/share/texmf/tex/context/base/supp-pdf.tex -(/usr/share/texmf/tex/context/base/supp-mis.tex -loading : Context Support Macros / Miscellaneous (2004.10.26) -\protectiondepth=\count98 -\scratchcounter=\count99 -\scratchtoks=\toks18 -\scratchdimen=\dimen111 -\scratchskip=\skip43 -\scratchmuskip=\muskip11 -\scratchbox=\box26 -\scratchread=\read1 -\scratchwrite=\write4 -\zeropoint=\dimen112 -\onepoint=\dimen113 -\onebasepoint=\dimen114 -\minusone=\count100 -\thousandpoint=\dimen115 -\onerealpoint=\dimen116 -\emptytoks=\toks19 -\nextbox=\box27 -\nextdepth=\dimen117 -\everyline=\toks20 -\!!counta=\count101 -\!!countb=\count102 -\recursecounter=\count103 -) -loading : Context Support Macros / PDF (2004.03.26) -\nofMPsegments=\count104 -\nofMParguments=\count105 -\MPscratchCnt=\count106 -\MPscratchDim=\dimen118 -\MPnumerator=\count107 -\everyMPtoPDFconversion=\toks21 -) Package hyperref Info: Link coloring ON on input line 32. - (/usr/share/texmf/tex/latex/hyperref/nameref.sty -Package: nameref 2003/12/03 v2.21 Cross-referencing by name of section -\c@section@level=\count108 -) LaTeX Info: Redefining \ref on input line 32. LaTeX Info: Redefining \pageref on input line 32. - (./LedgerSMB-manual.out) -(./LedgerSMB-manual.out) -\openout3 = `LedgerSMB-manual.out'. - -------------------- Geometry parameters paper: class default landscape: -- @@ -230,14 +518,14 @@ truedimen: -- includehead: -- includefoot: -- includemp: -- -driver: pdftex +driver: -------------------- Page layout dimensions and switches \paperwidth 614.295pt \paperheight 794.96999pt \textwidth 443.57848pt \textheight 624.25346pt -\oddsidemargin 13.08827pt -\evensidemargin 13.08827pt +\oddsidemargin 0.0pt +\evensidemargin 0.0pt \topmargin -23.91173pt \headheight 12.0pt \headsep 25.0pt @@ -252,277 +540,133 @@ driver: pdftex (1in=72.27pt, 1cm=28.45pt) ----------------------- +--- file LedgerSMB-manual.css --- + [1 + +] [2] LaTeX Font Info: External font `cmex10' loaded for size -(Font) <12> on input line 34. +(Font) <12> on input line 33. LaTeX Font Info: External font `cmex10' loaded for size -(Font) <8> on input line 34. +(Font) <8> on input line 33. LaTeX Font Info: External font `cmex10' loaded for size -(Font) <6> on input line 34. +(Font) <6> on input line 33. LaTeX Font Info: Try loading font information for OMS+ppl on input line 34. - (/usr/share/texmf/tex/latex/psnfss/omsppl.fd + +(/usr/local/texlive/2007/texmf-dist/tex/latex/psnfss/omsppl.fd File: omsppl.fd ) LaTeX Font Info: Font shape `OMS/ppl/m/n' in size <10> not available (Font) Font shape `OMS/cmsy/m/n' tried instead on input line 34. LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <14.4> not available (Font) Font shape `T1/ppl/b/n' tried instead on input line 42. +LaTeX Font Info: Try loading font information for T1+pcr on input line 42. -(./LedgerSMB-manual.toc +(/usr/local/texlive/2007/texmf-dist/tex/latex/psnfss/t1pcr.fd +File: t1pcr.fd 2001/06/04 font definitions for T1/pcr. +) +(./LedgerSMB-manual.4ct [3] [4] [5] [6]) [7] (./LedgerSMB-manual.4ct) [8] LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <12> not available -(Font) Font shape `T1/ppl/b/n' tried instead on input line 2. +(Font) Font shape `T1/ppl/b/n' tried instead on input line 56. LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <10> not available -(Font) Font shape `T1/ppl/b/n' tried instead on input line 3. -LaTeX Font Info: External font `cmex10' loaded for size -(Font) <7> on input line 4. -LaTeX Font Info: External font `cmex10' loaded for size -(Font) <5> on input line 4. - [1 - -{/usr/share/texmf-var/fonts/map/pdftex/updmap/pdftex.map}] [2] [3] [4] [5]) -\tf@toc=\write5 -\openout5 = `LedgerSMB-manual.toc'. - - (./LedgerSMB-manual.lof) -\tf@lof=\write6 -\openout6 = `LedgerSMB-manual.lof'. - - [6] -LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <20.74> not available -(Font) Font shape `T1/ppl/b/n' tried instead on input line 50. - [7 - -] [8] [9] [10] [11] -Overfull \hbox (0.23595pt too wide) in paragraph at lines 402--404 -[][]$\T1/ppl/m/n/10 http : / / www . accounting-[]and-[]bookkeeping-[]tips . co -m / learning-[]accounting / accounting-[]basics-[]credit . - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 402--404 - - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 405--407 - - [] - -[12] -Underfull \hbox (badness 10000) in paragraph at lines 408--411 - - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 412--414 - - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 415--417 - - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 418--420 +(Font) Font shape `T1/ppl/b/n' tried instead on input line 59. - [] +[9 +] [10] [11] [12] [13] [14] [15] [16] [17] [18] [19] +LaTeX Font Info: External font `cmex10' loaded for size +(Font) <7> on input line 526. +LaTeX Font Info: External font `cmex10' loaded for size +(Font) <5> on input line 526. + [20] [21] [22] +--- file LedgerSMB-manual2.html --- + [23 -Underfull \hbox (badness 10000) in paragraph at lines 421--423 - - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 424--426 - - [] - -[13] [14] [15] [16] [17] -Overfull \hbox (4.69608pt too wide) in paragraph at lines 810--813 -\T1/ppl/m/n/10 Services in-clude any la-bor that is billed di-rectly to the cus --tomer. It is as-so-ci-ated with an ex-pense/COGS - [] - -[18] [19] [20] [21] [22] [23] [24] (./simple_ar_dataflow.tex) [25] -(./ar_workflow_ship.tex) (./ar_workflow_complex.tex) -Overfull \hbox (90.87096pt too wide) in paragraph at lines 58--1393 -[][] - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 58--1393 - - [] - -[26] [27] [28] (./simple_ap_workflow.tex) (./ap_workflow_ship.tex) [29] -[30] (./ap_workflow_complex.tex) -Overfull \hbox (90.87096pt too wide) in paragraph at lines 58--1484 -[][] - [] - - -Underfull \hbox (badness 10000) in paragraph at lines 58--1484 - - [] - -[31] [32] [33] [34] [35] [36] [37] [38] [39] -Underfull \hbox (badness 10000) in paragraph at lines 2164--2167 - - [] - -[40] -LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <8> not available -(Font) Font shape `T1/ppl/b/n' tried instead on input line 2216. - -Overfull \hbox (0.31456pt too wide) in paragraph at lines 2237--2240 -\T1/ppl/m/n/10 L[]T[]X tem-plates al-low one to gen-er-ate PDF and postscript d -oc-u-ments and print di-rectly to a postscript- - [] - -LaTeX Font Info: Font shape `T1/ppl/bx/n' in size <7> not available -(Font) Font shape `T1/ppl/b/n' tried instead on input line 2246. -[41] - -Package hyperref Warning: Token not allowed in a PDFDocEncoded string: -(hyperref) \kern -1.66702pt -(hyperref) removed on input line 2270. - - -Package hyperref Warning: Token not allowed in a PDFDocEncoded string, -(hyperref) removing `\lower' on input line 2270. - - -Package hyperref Warning: Token not allowed in a PDFDocEncoded string, -(hyperref) removing `\hbox' on input line 2270. - - -Package hyperref Warning: Token not allowed in a PDFDocEncoded string: -(hyperref) \kern -1.25pt -(hyperref) removed on input line 2270. - +] +[24] [25] [26] [27] [28] [29] [30] [31] [32] [33] [34] [35 -Package hyperref Warning: Token not allowed in a PDFDocEncoded string, -(hyperref) removing `\spacefactor' on input line 2270. +] +(./simple_ar_dataflow.tex +l. 9 Writing LedgerSMB-manual.idv[1] (LedgerSMB-manual0x.png) +) [36 +] [37 -Package hyperref Warning: Token not allowed in a PDFDocEncoded string, -(hyperref) removing `\@m' on input line 2270. +] [38 -[42] -Overfull \hbox (45.1759pt too wide) in paragraph at lines 2342--2344 -[]\T1/ppl/m/n/10 cd /usr/local/ledger-smb ./ct.pl "lo-gin=name&path=bin&passwor -d=xxxxx&action=search&db=customer" - [] +] (./ar_workflow_ship.tex +l. 9 Writing LedgerSMB-manual.idv[2] (LedgerSMB-manual1x.png) +) [39 +] +[40 -Overfull \hbox (78.15541pt too wide) in paragraph at lines 2354--2356 -[]\T1/ppl/m/n/10 cd /usr/local/ledger-smb ./ct.pl "lo-gin=clarkkent&path=bin&pa -ssword=lOis,lAn3&action=search&db=customer" - [] +] [41 -LaTeX Font Info: Try loading font information for T1+pcr on input line 2389. +] (./ar_workflow_complex.tex +l. 9 Writing LedgerSMB-manual.idv[3] (LedgerSMB-manual2x.png) +) [42 -(/usr/share/texmf/tex/latex/psnfss/t1pcr.fd -File: t1pcr.fd 2001/06/04 font definitions for T1/pcr. -) [43] -Overfull \hbox (6.42152pt too wide) in paragraph at lines 2462--2462 -[]\T1/pcr/m/n/10 ARG="login=${LSLOGIN}&password=${LSPWD}&path=bin&action=search -&db=customer"[] - [] +] [43 -[44] -Overfull \hbox (24.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA -02111-1307, USA.[] - [] +] [44 -[45] -Overfull \hbox (0.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 $cmd = "login=" . $login . '&password=' . $pwd . '&path=bin&ac -tion=login';[] - [] +] (./simple_ap_workflow.tex +l. 9 Writing LedgerSMB-manual.idv[4] (LedgerSMB-manual3x.png) +) [45 -[46] -Overfull \hbox (6.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 $cmd = "login=" . $login . '&password=' . $pwd . '&path=bin&ac -tion=logout';[] - [] +] [46 -[47] -Overfull \hbox (156.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 # action | db | name | vendornumber | address1 | address2 | ci -ty | state | zipcode | country | phone[] - [] +] [47 +] (./ap_workflow_ship.tex +l. 9 Writing LedgerSMB-manual.idv[5] (LedgerSMB-manual4x.png) +) [48 -Overfull \hbox (102.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 save|vendor|Parts are Us|1377|238 Riverview|Suite 11|Cheese He -ad|WI|56743|USA|555-123-3322|[] - [] +] [49 +] [50 -Overfull \hbox (66.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 save|vendor|Widget Heaven|1378|41 S. Riparian Way||Show Me|MO| -39793|USA|555-231-3309|[] - [] +] +(./ap_workflow_complex.tex +l. 9 Writing LedgerSMB-manual.idv[6] (LedgerSMB-manual5x.png) +) [51 +] [52 -Overfull \hbox (216.42152pt too wide) in paragraph at lines 2646--2646 -[]\T1/pcr/m/n/10 save|vendor|Consolidated Spackle|1379|1010 Binary Lane|Dept 11 -01|Beverly Hills|CA|90210|USA|555-330-7639 x772|[] - [] +] [53] [54] [55] [56] [57] [58 -[48] (./sl-stack.tex) [49 +] [59 -] [50] -Overfull \hbox (3.85573pt too wide) in paragraph at lines 2838--2841 -[]\T1/ppl/m/n/10 The css di-rec-tory in the root in-stall di-rec-tory con-tains - CSS doc-u-ments to pro-vide var-i-ous stylesheets - [] +] +--- file LedgerSMB-manual3.html --- +--- file LedgerSMB-manual4.html --- -[51] [52] [53] [54] -Overfull \hbox (1.72615pt too wide) in paragraph at lines 3131--3137 -\T1/ppl/m/n/10 the name of the tem-plate within the cur-rent tem-plate di-rec-t -ory (usu-ally tem-plates/$username/). - [] +[60 -[55] [56] -Overfull \hbox (6.58676pt too wide) in paragraph at lines 3232--3237 -\T1/ppl/m/n/10 The $form ob-ject pro-vides two meth-ods for ac-cess-ing the dat -abase. The $form->dbconnect(%myconfig) - [] +] [61] [62] [63] [64] [65] [66] [67] [68] [69] [70] [71] [72] [73] [74] +[75] [76] [77] [78 -Overfull \hbox (40.4262pt too wide) in paragraph at lines 3232--3237 -\T1/ppl/m/n/10 method com-mits each in-di-vid-ual state-ment as its own trans-a -c-tion. The $form->dbconnect_noauto(%myconfig) - [] +] [79 -[57] [58 +] (./sl-stack.tex +l. 9 Writing LedgerSMB-manual.idv[7] (LedgerSMB-manual6x.png) +) [80 -] [59] [60] (./fdl.tex +] [81 -Package hyperref Warning: The anchor of a bookmark and its parent's must not -(hyperref) be the same. Added a new anchor on input line 51. +] [82] [83] [84] [85] +[86] [87] [88] [89] [90] [91 -[61] [62] [63] [64] [65]) [66] (./LedgerSMB-manual.aux) ) +] [92] [93] [94] (./fdl.tex [95] [96] [97] [98] +[99] [100] [101]) [102] (./LedgerSMB-manual.aux) ) Here is how much of TeX's memory you used: - 3986 strings out of 94500 - 53384 string characters out of 1176767 - 105595 words of memory out of 1000000 - 6774 multiletter control sequences out of 10000+50000 - 29317 words of font info for 55 fonts, out of 500000 for 2000 - 580 hyphenation exceptions out of 1000 - 34i,9n,41p,245b,277s stack positions out of 1500i,500n,5000p,200000b,5000s -PDF statistics: - 1504 PDF objects out of 300000 - 313 named destinations out of 131072 - 1873 words of extra memory for PDF output out of 65536 -{/usr/share/texmf/font -s/enc/dvips/psnfss/8r.enc}</usr/share/texmf/fonts/type1/urw/courier/ucrr8a.pfb> -</usr/share/texmf/fonts/type1/bluesky/latex/line10.pfb></usr/share/texmf/fonts/ -type1/bluesky/cm/cmr10.pfb></usr/share/texmf/fonts/type1/bluesky/cm/cmmi10.pfb> -</usr/share/texmf/fonts/type1/urw/palatino/uplb8a.pfb></usr/share/texmf/fonts/t -ype1/bluesky/cm/cmsy10.pfb></usr/share/texmf/fonts/type1/urw/palatino/uplr8a.pf -b> -Output written on LedgerSMB-manual.pdf (66 pages, 399165 bytes). + 7463 strings out of 94074 + 96343 string characters out of 1163007 + 262303 words of memory out of 1500000 + 10597 multiletter control sequences out of 10000+50000 + 16498 words of font info for 35 fonts, out of 1200000 for 2000 + 645 hyphenation exceptions out of 8191 + 35i,8n,40p,733b,792s stack positions out of 5000i,500n,6000p,200000b,5000s + +Output written on LedgerSMB-manual.dvi (102 pages, 385484 bytes). diff --git a/doc/manual/LedgerSMB-manual.out b/doc/manual/LedgerSMB-manual.out index 734ee0b8..f5b5041d 100644 --- a/doc/manual/LedgerSMB-manual.out +++ b/doc/manual/LedgerSMB-manual.out @@ -1,10 +1,10 @@ -\BOOKMARK [0][-]{part.1}{I Ledger-SMB and Business Processes}{} -\BOOKMARK [1][-]{section.1}{Introduction to Ledger-SMB}{part.1} -\BOOKMARK [2][-]{subsection.1.1}{Why Ledger-SMB}{section.1} -\BOOKMARK [3][-]{subsubsection.1.1.1}{Advantages of Ledger-SMB}{subsection.1.1} +\BOOKMARK [0][-]{part.1}{I LedgerSMB and Business Processes}{} +\BOOKMARK [1][-]{section.1}{Introduction to LedgerSMB}{part.1} +\BOOKMARK [2][-]{subsection.1.1}{Why LedgerSMB}{section.1} +\BOOKMARK [3][-]{subsubsection.1.1.1}{Advantages of LedgerSMB}{subsection.1.1} \BOOKMARK [3][-]{subsubsection.1.1.2}{Key Features}{subsection.1.1} -\BOOKMARK [2][-]{subsection.1.2}{Limitations of Ledger-SMB}{section.1} -\BOOKMARK [2][-]{subsection.1.3}{System Requirements of Ledger-SMB}{section.1} +\BOOKMARK [2][-]{subsection.1.2}{Limitations of LedgerSMB}{section.1} +\BOOKMARK [2][-]{subsection.1.3}{System Requirements of LedgerSMB}{section.1} \BOOKMARK [1][-]{section.2}{User Account and Database Administration Basics}{part.1} \BOOKMARK [2][-]{subsection.2.1}{Companies and Datasets}{section.2} \BOOKMARK [2][-]{subsection.2.2}{How to Create a User}{section.2} @@ -43,7 +43,7 @@ \BOOKMARK [3][-]{subsubsection.4.7.2}{SIC}{subsection.4.7} \BOOKMARK [3][-]{subsubsection.4.7.3}{Overview of Template Editing}{subsection.4.7} \BOOKMARK [3][-]{subsubsection.4.7.4}{Year-end}{subsection.4.7} -\BOOKMARK [2][-]{subsection.4.8}{Options in the ledger-smb.conf}{section.4} +\BOOKMARK [2][-]{subsection.4.8}{Options in the ledgersmb.conf}{section.4} \BOOKMARK [1][-]{section.5}{Goods and Services}{part.1} \BOOKMARK [2][-]{subsection.5.1}{Basic Terms}{section.5} \BOOKMARK [2][-]{subsection.5.2}{The Price Matrix}{section.5} @@ -131,7 +131,7 @@ \BOOKMARK [2][-]{subsection.12.1}{GL Basics}{section.12} \BOOKMARK [3][-]{subsubsection.12.1.1}{Paper-based accounting systems and the GL}{subsection.12.1} \BOOKMARK [3][-]{subsubsection.12.1.2}{Double Entry Examples on Paper}{subsection.12.1} -\BOOKMARK [3][-]{subsubsection.12.1.3}{The GL in Ledger-SMB}{subsection.12.1} +\BOOKMARK [3][-]{subsubsection.12.1.3}{The GL in LedgerSMB}{subsection.12.1} \BOOKMARK [2][-]{subsection.12.2}{Cash Transfer}{section.12} \BOOKMARK [2][-]{subsection.12.3}{GL Transactions}{section.12} \BOOKMARK [2][-]{subsection.12.4}{Payroll as a GL transaction}{section.12} @@ -211,23 +211,23 @@ \BOOKMARK [3][-]{subsubsection.20.4.1}{Database Access}{subsection.20.4} \BOOKMARK [2][-]{subsection.20.5}{CLI Examples}{section.20} \BOOKMARK [0][-]{part.3}{III Appendix}{} -\BOOKMARK [1][-]{section.A}{Where to Go for More Information}{part.3} -\BOOKMARK [1][-]{section.B}{Quick Tips}{part.3} -\BOOKMARK [2][-]{subsection.B.1}{Understanding Shipping Addresses and Carriers}{section.B} -\BOOKMARK [2][-]{subsection.B.2}{Handling bad debts}{section.B} -\BOOKMARK [1][-]{section.C}{Step by Steps for Vertical Markets}{part.3} -\BOOKMARK [2][-]{subsection.C.1}{Common Installation Errors}{section.C} -\BOOKMARK [2][-]{subsection.C.2}{Retail With Light Manufacturing}{section.C} -\BOOKMARK [1][-]{section.D}{Glossary}{part.3} -\BOOKMARK [1][-]{section.E}{GNU Free Documentation License}{part.3} -\BOOKMARK [2][-]{section*.3}{1. APPLICABILITY AND DEFINITIONS}{section.E} -\BOOKMARK [2][-]{section*.3}{2. VERBATIM COPYING}{section.E} -\BOOKMARK [2][-]{section*.3}{3. COPYING IN QUANTITY}{section.E} -\BOOKMARK [2][-]{section*.3}{4. MODIFICATIONS}{section.E} -\BOOKMARK [2][-]{section*.3}{5. COMBINING DOCUMENTS}{section.E} -\BOOKMARK [2][-]{section*.3}{6. COLLECTIONS OF DOCUMENTS}{section.E} -\BOOKMARK [2][-]{section*.3}{7. AGGREGATION WITH INDEPENDENT WORKS}{section.E} -\BOOKMARK [2][-]{section*.3}{8. TRANSLATION}{section.E} -\BOOKMARK [2][-]{section*.3}{9. TERMINATION}{section.E} -\BOOKMARK [2][-]{section*.3}{10. FUTURE REVISIONS OF THIS LICENSE}{section.E} -\BOOKMARK [2][-]{section*.3}{ADDENDUM: How to use this License for your documents}{section.E} +\BOOKMARK [1][-]{appendix.A}{Where to Go for More Information}{part.3} +\BOOKMARK [1][-]{appendix.B}{Quick Tips}{part.3} +\BOOKMARK [2][-]{subsection.B.1}{Understanding Shipping Addresses and Carriers}{appendix.B} +\BOOKMARK [2][-]{subsection.B.2}{Handling bad debts}{appendix.B} +\BOOKMARK [1][-]{appendix.C}{Step by Steps for Vertical Markets}{part.3} +\BOOKMARK [2][-]{subsection.C.1}{Common Installation Errors}{appendix.C} +\BOOKMARK [2][-]{subsection.C.2}{Retail With Light Manufacturing}{appendix.C} +\BOOKMARK [1][-]{appendix.D}{Glossary}{part.3} +\BOOKMARK [1][-]{appendix.E}{GNU Free Documentation License}{part.3} +\BOOKMARK [2][-]{section*.3}{1. APPLICABILITY AND DEFINITIONS}{appendix.E} +\BOOKMARK [2][-]{section*.3}{2. VERBATIM COPYING}{appendix.E} +\BOOKMARK [2][-]{section*.3}{3. COPYING IN QUANTITY}{appendix.E} +\BOOKMARK [2][-]{section*.3}{4. MODIFICATIONS}{appendix.E} +\BOOKMARK [2][-]{section*.3}{5. COMBINING DOCUMENTS}{appendix.E} +\BOOKMARK [2][-]{section*.3}{6. COLLECTIONS OF DOCUMENTS}{appendix.E} +\BOOKMARK [2][-]{section*.3}{7. AGGREGATION WITH INDEPENDENT WORKS}{appendix.E} +\BOOKMARK [2][-]{section*.3}{8. TRANSLATION}{appendix.E} +\BOOKMARK [2][-]{section*.3}{9. TERMINATION}{appendix.E} +\BOOKMARK [2][-]{section*.3}{10. FUTURE REVISIONS OF THIS LICENSE}{appendix.E} +\BOOKMARK [2][-]{section*.3}{ADDENDUM: How to use this License for your documents}{appendix.E} diff --git a/doc/manual/LedgerSMB-manual.tex b/doc/manual/LedgerSMB-manual.tex index 708de91f..7ab8eb2b 100644 --- a/doc/manual/LedgerSMB-manual.tex +++ b/doc/manual/LedgerSMB-manual.tex @@ -22,7 +22,7 @@ \usepackage{metatron} \renewcommand{\abstractname}{Executive Summary} -\title{Ledger-SMB Manual v. \version} +\title{LedgerSMB Manual v. \version} \author{The LedgerSMB Core Team} \date{\today} @@ -47,16 +47,16 @@ Documentation License\char`\"{} (Appendix \ref{fdl}). \clearpage -\part{Ledger-SMB and Business Processes} +\part{LedgerSMB and Business Processes} -\section{Introduction to Ledger-SMB} +\section{Introduction to LedgerSMB} -\subsection{Why Ledger-SMB} +\subsection{Why LedgerSMB} -\subsubsection{Advantages of Ledger-SMB} +\subsubsection{Advantages of LedgerSMB} \begin{itemize} \item Flexibility and Central Management @@ -132,7 +132,7 @@ your business. \item Point of Sale \begin{itemize} -\item Run multiple cash registers against main Ledger-SMB installation +\item Run multiple cash registers against main LedgerSMB installation \item Suitable for retail stores and more \item Credit card processing via TrustCommerce \item Supports some POS hardware out of the box including: @@ -170,7 +170,7 @@ reporting framework to meet any local requirement. \end{itemize} \end{itemize} -\subsection{Limitations of Ledger-SMB} +\subsection{Limitations of LedgerSMB} \begin{itemize} \item No payroll module (Payroll must be done manually) @@ -179,7 +179,7 @@ reporting framework to meet any local requirement. broad range of technologies \end{itemize} -\subsection{System Requirements of Ledger-SMB} +\subsection{System Requirements of LedgerSMB} \begin{itemize} \item PostgreSQL @@ -214,12 +214,12 @@ though Windows, MacOS X, etc. do work) \section{User Account and Database Administration Basics} These functions are accessed via the admin.pl script in the -installed directory of Ledger-SMB. +installed directory of LedgerSMB. \subsection{Companies and Datasets} -Ledger-SMB stores its information in locale-specific data sets. When +LedgerSMB stores its information in locale-specific data sets. When a dataset is created, it sets various defaults such as currency, a basic chart of accounts setup, and so forth. Note that the default setup is for Canada, where the author of the software resides. @@ -230,7 +230,7 @@ one company. If a customer is working with multiple companies, he/she must create a dataset to for each. When creating a dataset, the application asks for both a username and a -superusername. If the superuser's information is not filled in, Ledger-SMB will +superusername. If the superuser's information is not filled in, LedgerSMB will attempt to populate an existing dataset, but if this information is filled in, the program will log into the PostgreSQL cluster with the superusername and password, create the database, and attempt to add Plpgsql to it. @@ -244,7 +244,7 @@ the user is created. \subsection{Permissions} -The permissions system is not rigorously enforced within Ledger-SMB, +The permissions system is not rigorously enforced within LedgerSMB, in the sense that the permissions API is generally not used in the application itself. Instead permissions are used to enable/disable menu options. Setting an enforcement of such permissions would require @@ -431,7 +431,7 @@ of debits and credits and of double-entry. \subsection{General Guidelines on Numbering Accounts} -In general, most drop-down boxes in Ledger-SMB order the accounts +In general, most drop-down boxes in LedgerSMB order the accounts by account number. Therefore by setting appropriate account numbers, one can affect the default values. @@ -466,7 +466,7 @@ ledger for that account. \section{Administration} This section covers other (non-Chart of Accounts) aspects to the -setup of the Ledger-SMB accounting package. These are generally accessed +setup of the LedgerSMB accounting package. These are generally accessed in the System submenu. @@ -595,7 +595,7 @@ numbers. This was meant to ensure that one did not erase data from the accounting books (and as such that erasing data would be a sign of foul play). -Ledger-SMB has a capability to require such reversals if the business +LedgerSMB has a capability to require such reversals if the business deems this to be necessary. When this option is enabled, existing transactions cannot be modified and one will need to post reversing transactions to void existing transactions before posting corrected @@ -626,7 +626,7 @@ action was. No direct financial information is included. Departments are logical divisions of a business. They allow for budgets to be prepared for the individual department as well as the business -as a whole. This allows larger businesses to use Ledger-SMB to meet +as a whole. This allows larger businesses to use LedgerSMB to meet their needs. @@ -639,21 +639,21 @@ gain money. For example, the legal department in most companies is a cost center. One of the serious misunderstandings people run up against is that -Ledger-SMB tends to more narrowly define cost and profit centers than -most businesses do. In Ledger-SMB a cost center is any department +LedgerSMB tends to more narrowly define cost and profit centers than +most businesses do. In LedgerSMB a cost center is any department of the business that does not issue AR transactions. Although many businesses may have cost centers (like technical support) where customer -fees may subsidize the cost of providing the service, in Ledger-SMB, +fees may subsidize the cost of providing the service, in LedgerSMB, these are profit centers. -Ledger-SMB will not allow cost centers to be associated with AR transactions. +LedgerSMB will not allow cost centers to be associated with AR transactions. So if you want this functionality, you must create the department as a profit center. \subsection{Warehouses} -Ledger-SMB has the ability to track inventory by warehouse. Inventory +LedgerSMB has the ability to track inventory by warehouse. Inventory items can be moved between warehouses, and shipped from any warehouse where the item is in stock. We will explore this concept more later. @@ -697,14 +697,14 @@ field for custom reporting and marketing purposes. \subsubsection{Overview of Template Editing} The templates for invoices, orders, and the like can be edited from -within Ledger-SMB. The submenus within the System submenu such as +within LedgerSMB. The submenus within the System submenu such as HTML Templates, Text Templates and \LaTeX{} templates provide access to this functionality. \subsubsection{Year-end} -Although the Year-end functionality in Ledger-SMB is very useful, +Although the Year-end functionality in LedgerSMB is very useful, it does not entirely make the process simple and painless. One must still manually enter adjustments prior to closing the books. The extent to which these adjustments are necessary for any given business is @@ -722,7 +722,7 @@ of the amount invested in a business, but any dividends ought not to count against their recipients when new investors are brought on board. -Ledger-SMB automatically moves all income and expense into the specified +LedgerSMB automatically moves all income and expense into the specified year-end/retained earnings account. It does not move the drawing account, and this must be done manually, nor does it automate the process of making adjustments. @@ -731,9 +731,9 @@ Contrary to its name, this function can close the books at any time, though this would likely be of limited use. -\subsection{Options in the ledger-smb.conf} +\subsection{Options in the ledgersmb.conf} -The ledger-smb.conf configures the software by assigning site-wide +The ledgersmb.conf configures the software by assigning site-wide variables. Most of these should be left alone unless one knows what one is doing. However, on some systems some options might need to be changed, so all options are presented here for reference: @@ -744,7 +744,7 @@ be changed, so all options are presented here for reference: email from standard input. \item[language] allows one to set the language for the login screen and admin page. -\item[latex] tells Ledger-SMB whether \LaTeX{} is installed. \LaTeX{} is +\item[latex] tells LedgerSMB whether \LaTeX{} is installed. \LaTeX{} is required for generating Postscript and PDF invoices and the like. \item[Environmental variables] can be set here too. One can add paths for searching for \LaTeX{}, etc. @@ -832,7 +832,7 @@ associated with sales tax. \subsection{Assemblies and Manufacturing} Manufacturers order parts but they sell the products of their efforts. -Ledger-SMB supports manufacturing using the concept of assemblies. +LedgerSMB supports manufacturing using the concept of assemblies. An assembly is any product which is manufactured on site. It consists of a selection of parts, services, and/or labor and overhead. Assemblies are treated as parts in most other regards. @@ -847,7 +847,7 @@ One stocks assemblies in the Stock Assembly entry on the Goods and Services submenu. When an assembly is stocked the inventory is adjusted properly. -The Check Inventory option will cause Ledger-SMB to refuse to stock +The Check Inventory option will cause LedgerSMB to refuse to stock an assembly if the inventory required to produce the assembly would drop the part below the reorder point. @@ -1002,7 +1002,7 @@ The AP Invoice section has a capacity to separate internal notes from notes printed on the invoice. Note, however, that since these are received invoices, it is rare that one needs this ability. -Note that Ledger-SMB can search for partial part numbers or descriptions. +Note that LedgerSMB can search for partial part numbers or descriptions. Also if you have a group you can use this to select the part. @@ -1220,7 +1220,7 @@ not discussed in these notes. A project is a logical collection of AR and AP transactions, orders, and the like that allow one to better manage specific service or product -offerings. Ledger-SMB does not offer comprehensive project management +offerings. LedgerSMB does not offer comprehensive project management capabilities, and projects are only used here as they relate to accounting. One can also add translated descriptions to the project names as well. @@ -1280,7 +1280,7 @@ a variety of customers. \section{Quotations and Order Management} -This unit will introduce the business processes that Ledger-SMB allows. +This unit will introduce the business processes that LedgerSMB allows. These processes are designed to allow various types of businesses to manage their orders and allow for rudimentary customer relationship management processes to be built around this software. In this section, @@ -1611,7 +1611,7 @@ All entries are grouped by date and source in this report. \subsection{GL Basics} -The General Ledger is the heart of Ledger-SMB. Indeed, Ledger-SMB +The General Ledger is the heart of LedgerSMB. Indeed, LedgerSMB is designed to be as close as possible to a software equivalent of a paper-based accounting program (but with no difference between the General Ledger and General Journal). @@ -1739,7 +1739,7 @@ J1 & -\subsubsection{The GL in Ledger-SMB} +\subsubsection{The GL in LedgerSMB} The paper-based accounting procedure works well when one is stuck with paper recording requirements but it has one serious deficiency--- @@ -1751,18 +1751,18 @@ way a General Journal is used in the paper-based systems and then present the same information in ways which are more closely related to the General Ledger book. -This is the exact way that the General Ledger is used in Ledger-SMB. +This is the exact way that the General Ledger is used in LedgerSMB. The actual data is entered and stored as if it was a general journal, and then the data can be presented in any number of different ways. -All modules of Ledger-SMB that involve COA accounts store their data +All modules of LedgerSMB that involve COA accounts store their data in the General Ledger (it is a little more complex than this but this is very close to the actual mechanism). \subsection{Cash Transfer} -The simplest form of GL entry in Ledger-SMB is the Cash-\textgreater +The simplest form of GL entry in LedgerSMB is the Cash-\textgreater Transfer screen. This screen shows two transaction lines, and fields for reference, department, description, and notes. @@ -1873,7 +1873,7 @@ stored for reconciliation purposes.% \subsection{Reports} -The most flexible report in Ledger-SMB is the GL report because it +The most flexible report in LedgerSMB is the GL report because it has access to the entire set of financial transactions of a business. Every invoice posted, payment made or received, etc. can be located here. @@ -1931,7 +1931,7 @@ intervals. To schedule any GL, AR, or AP transaction or invoice, click the schedule button. In general the reference number should be left blank as this will -force Ledger-SMB to create a new invoice or transaction number for +force LedgerSMB to create a new invoice or transaction number for each iteration. The rest of the options are self-explanatory. Note that a blank number if iterations will result in no recurrences of the transaction. @@ -2017,7 +2017,7 @@ been reconciled. If the trial balance does not balance, get technical support immediately. This usually means that transactions were not entered properly. Some may have been out of balance, or some may have gone into non-existent -accounts (believe it or not, Ledger-SMB does not check this latter +accounts (believe it or not, LedgerSMB does not check this latter issue). @@ -2089,7 +2089,7 @@ need to be addressed. \subsection{Balance Sheet} The balance sheet is the second major accounting statement supported -by Ledger-SMB. The balance sheet provides a snapshot of the current +by LedgerSMB. The balance sheet provides a snapshot of the current financial health of the business by comparing assets, liabilities, and equity. @@ -2133,7 +2133,7 @@ transactions were entered or that transactions did not post properly. \subsection{No Statement of Owner Equity?} The Statement of Owner Equity is the one accounting statement that -Ledger-SMB does not support. However, it can be simulated by running +LedgerSMB does not support. However, it can be simulated by running a balance sheet at the end of the time frame in question and comparing it to the beginning. One can check this against an income statement for the period in question to verify its accuracy. The statement of @@ -2142,7 +2142,7 @@ owner equity is not as commonly used now as it once was. \section{The Template System} -Ledger-SMB allows most documents to be generated according to a template +LedgerSMB allows most documents to be generated according to a template system. This allows financial statements, invoices, orders, and the like to be customized to meet the needs of most businesses. Company logos can be inserted, the format can be radically altered, one can @@ -2162,11 +2162,11 @@ This example provides the simplest way to understand the template system. The first two lines are:\\ - \textless\%company align=center width=40\%\textgreater\\ - \textless\%address align=center width=40\%\textgreater\\ + \textless?lsmb company align=center width=40 ?\textgreater\\ + \textless?lsmb address align=center width=40 ?\textgreater\\ -The first line tells Ledger-SMB to print the company name as passed +The first line tells LedgerSMB to print the company name as passed to it via a variable, centered, with a page width of 40 characters. The second line does the same thing with the address. @@ -2175,8 +2175,8 @@ These variables are usually passed to the invoice using form fields however, can disable some of these fields or add others via database lookups and the like. -In all types of templates, variable substitution occurs between \textless\% -and \%\textgreater. One can optionally specify an alignment or a +In all types of templates, variable substitution occurs between \textless?lsmb +and ?\textgreater. One can optionally specify an alignment or a width but these are really only useful in text templates. @@ -2295,8 +2295,8 @@ the rest of the page format is not thrown off by it. \subsection{How are They Stored in the Filesystem?} The template directory (\char`\"{}templates\char`\"{} in the root -Ledger-SMB install directory) contains all the root templates used -by Ledger-SMB. These follow a naming convention of COAType-templatename.ext +LedgerSMB install directory) contains all the root templates used +by LedgerSMB. These follow a naming convention of COAType-templatename.ext where COAType is the type of dataset that was created when the user was created, templatename is the name of the template, and ext is either txt, html, or tex (for text, html, and \LaTeX{}\ respectively). @@ -2304,13 +2304,13 @@ either txt, html, or tex (for text, html, and \LaTeX{}\ respectively). Inside this directory are one or more subdirectories where the relevant templates have been copied as default language templates for the user. Many users can use the same user directory (which bears the name of -the Ledger-SMB username). Within this directory are more subdirectories +the LedgerSMB username). Within this directory are more subdirectories for translated templates, one for each language created. \subsection{Upgrade Issues} -When Ledger-SMB is upgraded, the templates are not replaced. This +When LedgerSMB is upgraded, the templates are not replaced. This is designed to prevent the upgrade script from overwriting changes made during the course of customizing the templates. @@ -2328,7 +2328,7 @@ The command-line API will be referred to as the API. \subsection{Preliminaries} -Logging into Ledger-SMB (1.2+) updates a row in the users\_conf table +Logging into LedgerSMB (1.2+) updates a row in the users\_conf table containing your account configuration defaults and other information. The implication for API users of LSMB is that you must login as part of running API scripts. For security purposes, it is recommended that @@ -2339,19 +2339,19 @@ directory. Consider a simple example: - cd /usr/local/ledger-smb + cd /usr/local/ledgersmb ./ct.pl "login=name\&path=bin\&password=xxxxx\&action=search\&db=customer" The cd command moves your terminal session's current working directory into -the main Ledger-SMB directory. Then the Ledger-SMB perl script ct.pl is called +the main LedgerSMB directory. Then the LedgerSMB perl script ct.pl is called with one long line as an argument. The argument is really several variable=value pairs separated by ampersands (\&). The value for the login variable is the username -that Ledger-SMB is to use, and the value for the password variable is the plaintext password. +that LedgerSMB is to use, and the value for the password variable is the plaintext password. To build our examples we will use a username of "clarkkent" who has a password of "lOis,lAn3". - cd /usr/local/ledger-smb + cd /usr/local/ledgersmb ./ct.pl "login=clarkkent\&path=bin\&password=lOis,lAn3\&action=search\&db=customer" If we execute these commands we will get the html for the search form for @@ -2367,14 +2367,14 @@ to do some useful work. This is a bash script which: 1. sets NOW to the current working directory - 2. prompts for and reads your Ledger-SMB login - 3. prompts for and reads (non-echoing) your Ledger-SMB password - 4. changes directory to /usr/local/ledger-smb + 2. prompts for and reads your LedgerSMB login + 3. prompts for and reads (non-echoing) your LedgerSMB password + 4. changes directory to /usr/local/ledgersmb 5. constructs login and logout commands and a transaction command - 6. logins into ledger-smb (in a real program, output would be checked for + 6. logs into ledgersmb (in a real program, output would be checked for success or failure) 7. executes the transaction - 8. logs out of ledger-smb (although this is not necessary) + 8. logs out of ledgersmb (although this is not necessary) 9. returns to the original working directory 10. exits @@ -2382,9 +2382,9 @@ Running lsmb01-cli-example.sh produces: \$ lsmb01-cli-example.sh -Ledger-SMB login: clarkkent +LedgerSMB login: clarkkent -Ledger-SMB password: +LedgerSMB password: \begin{verbatim} <body> @@ -2435,11 +2435,11 @@ command line API. NOW=`pwd` -echo -n "Ledger-SMB login: " +echo -n "LedgerSMB login: " read LSLOGIN echo -echo -n "Ledger-SMB password: " +echo -n "LedgerSMB password: " stty -echo read LSPWD stty echo @@ -2450,7 +2450,7 @@ ARG="login=${LSLOGIN}&password=${LSPWD}&path=bin&action=search&db=customer" LGIN="login=${LSLOGIN}&password=${LSPWD}&path=bin&action=login" LGOT="login=${LSLOGIN}&password=${LSPWD}&path=bin&action=logout" -cd /usr/local/ledger-smb +cd /usr/local/ledgersmb ./login.pl $LGIN 2>&1 > /dev/null ./ct.pl $ARG @@ -2471,9 +2471,9 @@ above, though it is still fairly limited. If your needs require, rather than hav the script build and then execute the commands it could be written to generate a shell script which is executed by hand. -This script begins by prompting for your Ledger-SMB login and password. Using +This script begins by prompting for your LedgerSMB login and password. Using the supplied values a login command is constructed and passed into the runLScmd -subroutine. runLScmd changes directory to /usr/local/ledger-smb/ for the length +subroutine. runLScmd changes directory to /usr/local/ledgersmb/ for the length of the subroutine. It formats the command and executes it and returns both the output and error information to the caller in a scalar. @@ -2491,7 +2491,7 @@ logout and the script exits. #!/usr/bin/perl -w # # File: lsmb02-cli-example.pl -# Environment: Ledger-SMB 1.2.0+ +# Environment: LedgerSMB 1.2.0+ # Author: Louis B. Moore # # Copyright (C) 2006 Louis B. Moore @@ -2519,12 +2519,12 @@ use File::chdir; use HTML::Entities; -print "\n\nLedger-SMB login: "; +print "\n\nLedgerSMB login: "; my $login = <STDIN>; chomp($login); -print "\nLedger-SMB password: "; +print "\nLedgerSMB password: "; system("stty -echo"); my $pwd = <STDIN>; system("stty echo"); @@ -2605,7 +2605,7 @@ sub runLScmd { my $i = 0; my $results; - local $CWD = "/usr/local/ledger-smb/"; + local $CWD = "/usr/local/ledgersmb/"; $cmd = $cmd . " \"" . $args . "\""; @@ -2654,7 +2654,7 @@ save|vendor|Consolidated Spackle|1379|1010 Binary Lane|Dept 1101|Beverly Hills|C \section{Basic Architecture} -Ledger-SMB is a web-based Perl program that interfaces with PostgreSQL +LedgerSMB is a web-based Perl program that interfaces with PostgreSQL using the relevant Perl modules. The code is well partitioned, and the main operation modules are written in an object oriented way. @@ -2666,29 +2666,29 @@ the main operation modules are written in an object oriented way. \label{fig-sl-stack} \input{sl-stack.tex} -\caption{The Ledger-SMB software stack in a Typical Implementation} +\caption{The LedgerSMB software stack in a Typical Implementation} \end{figure} -Ledger-SMB runs in a Perl interpreter. I do not currently know if +LedgerSMB runs in a Perl interpreter. I do not currently know if it is possible to run it with Perl2C or other language converters to run in other environments. However, except for high-capacity environments, Perl is a good language choice for this sort of program. -Ledger-SMB used to support DB2 and Oracle as well as PostgreSQL. However, +LedgerSMB used to support DB2 and Oracle as well as PostgreSQL. However, currently some of the functionality is implemented using PostgreSQL user-defined functions. These would need to be ported to other database managers in order to make the software work on these. It should not be too hard, but the fact that it has not been done yet may mean that there is no real demand for running the software under other RDBMS's. -One can substitute other web servers for Apache. Normally Ledger-SMB +One can substitute other web servers for Apache. Normally LedgerSMB is run as a CGI program but it may be possible to run it in the web server process (note that this may not be entirely thread-safe). The operating system can be any that supports a web server and Perl (since PostgreSQL need not run on the same system). However, there -are a few issues running Ledger-SMB on Windows (most notably in trying +are a few issues running LedgerSMB on Windows (most notably in trying to get Postscript documents to print properly). On the client side, any web-browser will work. Currently, the layout @@ -2700,29 +2700,29 @@ properly, though the application is usable without these features. \subsection{Capacity Planning} -Some companies may ask how scalable Ledger-SMB is. In general, it +Some companies may ask how scalable LedgerSMB is. In general, it is assumed that few companies are going to have a need for a high-concurrency -accounting system. However, with all the features available in Ledger-SMB, +accounting system. However, with all the features available in LedgerSMB, the staff that may have access to some of the application may be senior enough to make the question worthwhile. This question also becomes more important when companies might look -at integrating Ledger-SMB with a CRM solution, online store, or other +at integrating LedgerSMB with a CRM solution, online store, or other environment. This section looks at a number of the known issues and their solutions. \subsubsection{Scalability Strategies} -Ledger-SMB is a fairly standard web-based application. However, +LedgerSMB is a fairly standard web-based application. However, sometimes the database schema changes during upgrades. In these cases, it becomes impossible to use different versions of the software against -the same database version safely. Ledger-SMB checks the version of +the same database version safely. LedgerSMB checks the version of the database and if the version is higher than the version of the software that is running, will refuse to run. Therefore although one strategy might be to run several front-end -web servers with Ledger-SMB, in reality this can be a bit of a problem. +web servers with LedgerSMB, in reality this can be a bit of a problem. One solution is to take half of the front-end servers off-line while doing the initial upgrade, and then take the other offline to upgrade when these are brought back online. @@ -2738,7 +2738,7 @@ be able to move staff who do not need real-time access to new entries onto a PG-Pool/Slony-I cluster where new transactions are entered on the master and other data is looked up on the replica. In certain circumstances, one can also offload a number of other queries from -the master database in order to minimize the load. Ledger-SMB has +the master database in order to minimize the load. LedgerSMB has very few issues in the scalability of the application. @@ -2753,7 +2753,7 @@ those old rows are removed, performance can degrade as PostgreSQL has to search through all the old versions of the row in order to determine which one ought to be the current one. -Due to the way the SQL statements are executed in Ledger-SMB, most +Due to the way the SQL statements are executed in LedgerSMB, most inserts will also create a dead row. A second problem occurs in that each transaction is given a transaction @@ -2810,20 +2810,20 @@ the source code and edit the database queries to omit unused tables. \section{Customization Possibilities} -Ledger-SMB is designed to be customized relatively easily and rapidly. +LedgerSMB is designed to be customized relatively easily and rapidly. In general, the source code is well written and compartmentalized. This section covers the basic possibilities involving customization. \subsection{Brief Guide to the Source Code} -Ledger-SMB is an application with over 34000 lines of code. While +LedgerSMB is an application with over 34000 lines of code. While it is not possible to cover the entire application here, a brief overview of the source code is in order. In the root of the install directory, one will find a setup.pl program, a number of other .pl programs, and a number of directories. The setup.pl -program is used to update or install Ledger-SMB. The other .pl programs +program is used to update or install LedgerSMB. The other .pl programs provide a basic set of services for the framework (including authentication) and then pass the work on to the data entry screen file in the bin directory. @@ -2839,12 +2839,12 @@ The css directory in the root install directory contains CSS documents to provide various stylesheets one can select for changing various aspects of the look and feel of the application. -The locale directory contains translation files that Ledger-SMB uses +The locale directory contains translation files that LedgerSMB uses to translate between different languages. One could add translations to these files if necessary. The LSMB directory is where the Perl modules reside that provide the -core business logic in Ledger-SMB. These modules provide functionality +core business logic in LedgerSMB. These modules provide functionality such as form handling, email capabilities, and access to the database through its at least partially object oriented API. @@ -2865,7 +2865,7 @@ on the last partnumber field, removed separate print and post buttons to ensure that invoices were always printed and posted together, and removed the ability to print to the screen, and even the ability to scan items in when an invoice was received (using a portable data -terminal) and import this data into Ledger-SMB. Finally we added the +terminal) and import this data into LedgerSMB. Finally we added the ability to reconcile the till online in a paperless manner. For another customer, we added the ability to print AR invoices in @@ -2909,9 +2909,9 @@ on load. \subsection{Reports} The fact that all the data is available within the database manager -is a huge advantage of Ledger-SMB over Quickbooks and the like. The +is a huge advantage of LedgerSMB over Quickbooks and the like. The rapid development of reports allows for one to easily develop reports -of any sort within Ledger-SMB. +of any sort within LedgerSMB. \subsubsection{Examples} @@ -2931,7 +2931,7 @@ integrate a large number of tools. \subsection{Reporting Tools} Any reporting tool which can access the PostgreSQL database can be -used with Ledger-SMB for custom reporting. These can include programs +used with LedgerSMB for custom reporting. These can include programs like Microsoft Access and Excel (using the ODBC drivers), PgAccess (A PostgreSQL front-end written in TCL/Tk with a similar feel to Access), Rekall, Crystal Reports, OpenOffice and more. @@ -2944,7 +2944,7 @@ used the ODBC driver to import these into Excel. Excel can also read HTML tables, so one can use PostgreSQL to create an HTML table of the result and save it with a .xls extension so that Windows opens it with Excel. These could then be served via the same web server -that serves Ledger-SMB. +that serves LedgerSMB. \subsection{Line of Business Tools on PostgreSQL} @@ -2952,14 +2952,14 @@ that serves Ledger-SMB. Various line of business tools have been written using PostgreSQL in large part due to the fact that it is far more mature than MySQL in areas relating to data integrity enforcement, transactional processing, -and the like. These tools can be integrated with Ledger-SMB in various +and the like. These tools can be integrated with LedgerSMB in various ways. One could integrate this program with the HERMES CRM framework, for example. \subsubsection{Known Issues} -Ledger-SMB uses a single 'id' sequence across many tables. At the +LedgerSMB uses a single 'id' sequence across many tables. At the same time it is expected that these tables do not have identical id values in their records as they are used as a sort of pseudo-foreign key by the acc\_trans table which stores the financial transaction @@ -2978,13 +2978,13 @@ from integration in the same database but under different schemas. This allows PostgreSQL to become the main method of synchronizing the data in real time. However, sometimes this can require dumping the database, recreating the tables etc. in a different schema and -importing the data back into Ledger-SMB. +importing the data back into LedgerSMB. One possibility for this sort of integration is to use database triggers to replicate the data between the applications in real-time. This can avoid the main issue of duplicate id's. One issue that can occur however relates to updates. If one updates a customer record in HERMES, -for example, how do we know which record to update in Ledger-SMB? +for example, how do we know which record to update in LedgerSMB? There are solutions to this problem but they do require some forethought. A second possibility is to use views to allow one application to present @@ -2995,15 +2995,15 @@ fields. \subsubsection{Examples} -Others have integrated L'ane POS and Ledger-SMB in order to make it +Others have integrated L'ane POS and LedgerSMB in order to make it work better with touch screen devices. Still others have successfully -integrated Ledger-SMB and Interchange. In both cases, I believe that +integrated LedgerSMB and Interchange. In both cases, I believe that triggers were used to perform the actual integration. \subsection{Line of Business Tools on other RDBMS's} -Often there are requests to integrate Ledger-SMB with applications +Often there are requests to integrate LedgerSMB with applications like SugarCRM, OSCommerce, and other applications running on MySQL or other database managers. This is a far more complex field and it requires a great deal more effort than integrating applications within @@ -3024,7 +3024,7 @@ In general, it is usually advisable to add two fields to the record-- one that shows the insert time and one that shows the last update. Additionally, I would suggest adding additional information to the -Ledger-SMB tables so that you can track the source record from the +LedgerSMB tables so that you can track the source record from the other application in the case of an update. In general, one must write replication scripts that dump the information @@ -3062,7 +3062,7 @@ as instantiating the form object, ensuring that the user is logged in, and the like. They then pass the execution off to the user interface script (usually in the bin/mozilla directory). -Ledger-SMB in many ways may look sort of object oriented in its design, +LedgerSMB in many ways may look sort of object oriented in its design, but in reality, it is far more data-driven than object oriented. The Form object is used largely as a global symbol table and also as a collection of fundamental routines for things like database access. @@ -3078,7 +3078,7 @@ object. \subsection{Customizing Templates} Templates are used to generate printed checks, invoices, receipts, -and more in Ledger-SMB. Often the format of these items does not fit +and more in LedgerSMB. Often the format of these items does not fit a specific set of requirements and needs to be changed. This document will not include \LaTeX{} or HTML instruction, but will include a general introduction to editing templates. Also, this is not intended @@ -3154,7 +3154,8 @@ with two passes (if the inclusion of the cross-reference data moves the object to another page). In this case you will need to use three passes of \LaTeX{}\ in order to have accurate references. -Ledger-SMB as of the time of this writing (2.6.8) only makes one pass +% SC: Check further on this. I know that version is an SL reference +LedgerSMB as of the time of this writing (2.6.8) only makes one pass at the \LaTeX{}\ file. To force it to make more than one pass, open Form.pm with your favorite text editor. Look for the line: @@ -3186,7 +3187,7 @@ alignment). \subsection{Customizing Forms} Data entry forms and other user interface pieces are in the bin directory. -In Ledger-SMB 1.0.0 and later, symlinks are not generally used. +In LedgerSMB 1.0.0 and later, symlinks are not generally used. Each module is identified with a two letter combination: ar, ap, cp, etc. These combinations are generally explained in the comment headers @@ -3252,7 +3253,7 @@ LedgerSMB. You can find his page at \url{http://www.sql-ledger.org/cgi-bin/nav. \section{Where to Go for More Information} -There are a couple of relevant sources of information on Ledger-SMB +There are a couple of relevant sources of information on LedgerSMB in particular. The most important resources are the LedgerSMB web site @@ -3260,7 +3261,7 @@ The most important resources are the LedgerSMB web site site. In addition, it is generally recommended that the main bookkeeper -of a company using Ledger-SMB work through at least one accounting +of a company using LedgerSMB work through at least one accounting textbook. Which textbook is not as important as the fact that a textbook is used. @@ -3298,7 +3299,7 @@ it is posted as an expense. \subsection{Common Installation Errors} \begin{itemize} -\item Ledger-SMB is generally best installed in its own directory outside +\item LedgerSMB is generally best installed in its own directory outside of the wwwroot directory. While it is possible to install it inside the wwwroot directory, the instructions and the faq don't cover the common problems here. @@ -3315,7 +3316,7 @@ For purposes of this example we will use a business that assembles computers and sells them on a retail store. \begin{enumerate} -\item Install Ledger-SMB. +\item Install LedgerSMB. \item Set preferences, and customize chart of accounts. \begin{enumerate} @@ -3382,14 +3383,14 @@ the record and optionally use it to create an invoice, etc. \begin{itemize} \item Saving a customer returns to the customer screen. After the appropriate -invoice, transaction, etc. is entered and posted, Ledger-SMB will +invoice, transaction, etc. is entered and posted, LedgerSMB will return to the add customer screen. \end{itemize} \end{itemize} \item One can use the requirements report to help determine what parts need to be ordered though one cannot generate PO's directly from this report. \end{enumerate} -Note, the needs of Ledger-SMB are mostly useful for light manufacturing +Note, the needs of LedgerSMB are mostly useful for light manufacturing operations (assembling computers, for example). More manufacturing capabilities are expected to be released in the next version. diff --git a/doc/manual/LedgerSMB-manual.toc b/doc/manual/LedgerSMB-manual.toc index 295e9a18..25fcad7f 100644 --- a/doc/manual/LedgerSMB-manual.toc +++ b/doc/manual/LedgerSMB-manual.toc @@ -1,11 +1,11 @@ \select@language {english} -\contentsline {part}{I\hspace {1em}Ledger-SMB and Business Processes}{7}{part.1} -\contentsline {section}{\numberline {1}Introduction to Ledger-SMB}{7}{section.1} -\contentsline {subsection}{\numberline {1.1}Why Ledger-SMB}{7}{subsection.1.1} -\contentsline {subsubsection}{\numberline {1.1.1}Advantages of Ledger-SMB}{7}{subsubsection.1.1.1} +\contentsline {part}{I\hspace {1em}LedgerSMB and Business Processes}{7}{part.1} +\contentsline {section}{\numberline {1}Introduction to LedgerSMB}{7}{section.1} +\contentsline {subsection}{\numberline {1.1}Why LedgerSMB}{7}{subsection.1.1} +\contentsline {subsubsection}{\numberline {1.1.1}Advantages of LedgerSMB}{7}{subsubsection.1.1.1} \contentsline {subsubsection}{\numberline {1.1.2}Key Features}{7}{subsubsection.1.1.2} -\contentsline {subsection}{\numberline {1.2}Limitations of Ledger-SMB}{9}{subsection.1.2} -\contentsline {subsection}{\numberline {1.3}System Requirements of Ledger-SMB}{9}{subsection.1.3} +\contentsline {subsection}{\numberline {1.2}Limitations of LedgerSMB}{9}{subsection.1.2} +\contentsline {subsection}{\numberline {1.3}System Requirements of LedgerSMB}{9}{subsection.1.3} \contentsline {section}{\numberline {2}User Account and Database Administration Basics}{9}{section.2} \contentsline {subsection}{\numberline {2.1}Companies and Datasets}{10}{subsection.2.1} \contentsline {subsection}{\numberline {2.2}How to Create a User}{10}{subsection.2.2} @@ -44,7 +44,7 @@ \contentsline {subsubsection}{\numberline {4.7.2}SIC}{16}{subsubsection.4.7.2} \contentsline {subsubsection}{\numberline {4.7.3}Overview of Template Editing}{17}{subsubsection.4.7.3} \contentsline {subsubsection}{\numberline {4.7.4}Year-end}{17}{subsubsection.4.7.4} -\contentsline {subsection}{\numberline {4.8}Options in the ledger-smb.conf}{17}{subsection.4.8} +\contentsline {subsection}{\numberline {4.8}Options in the ledgersmb.conf}{17}{subsection.4.8} \contentsline {section}{\numberline {5}Goods and Services}{17}{section.5} \contentsline {subsection}{\numberline {5.1}Basic Terms}{18}{subsection.5.1} \contentsline {subsection}{\numberline {5.2}The Price Matrix}{18}{subsection.5.2} @@ -132,7 +132,7 @@ \contentsline {subsection}{\numberline {12.1}GL Basics}{33}{subsection.12.1} \contentsline {subsubsection}{\numberline {12.1.1}Paper-based accounting systems and the GL}{33}{subsubsection.12.1.1} \contentsline {subsubsection}{\numberline {12.1.2}Double Entry Examples on Paper}{34}{subsubsection.12.1.2} -\contentsline {subsubsection}{\numberline {12.1.3}The GL in Ledger-SMB}{34}{subsubsection.12.1.3} +\contentsline {subsubsection}{\numberline {12.1.3}The GL in LedgerSMB}{34}{subsubsection.12.1.3} \contentsline {subsection}{\numberline {12.2}Cash Transfer}{34}{subsection.12.2} \contentsline {subsection}{\numberline {12.3}GL Transactions}{35}{subsection.12.3} \contentsline {subsection}{\numberline {12.4}Payroll as a GL transaction}{35}{subsection.12.4} @@ -212,15 +212,15 @@ \contentsline {subsubsection}{\numberline {20.4.1}Database Access}{57}{subsubsection.20.4.1} \contentsline {subsection}{\numberline {20.5}CLI Examples}{57}{subsection.20.5} \contentsline {part}{III\hspace {1em}Appendix}{58}{part.3} -\contentsline {section}{\numberline {A}Where to Go for More Information}{58}{section.A} -\contentsline {section}{\numberline {B}Quick Tips}{58}{section.B} +\contentsline {section}{\numberline {A}Where to Go for More Information}{58}{appendix.A} +\contentsline {section}{\numberline {B}Quick Tips}{58}{appendix.B} \contentsline {subsection}{\numberline {B.1}Understanding Shipping Addresses and Carriers}{58}{subsection.B.1} \contentsline {subsection}{\numberline {B.2}Handling bad debts}{58}{subsection.B.2} -\contentsline {section}{\numberline {C}Step by Steps for Vertical Markets}{58}{section.C} +\contentsline {section}{\numberline {C}Step by Steps for Vertical Markets}{58}{appendix.C} \contentsline {subsection}{\numberline {C.1}Common Installation Errors}{58}{subsection.C.1} \contentsline {subsection}{\numberline {C.2}Retail With Light Manufacturing}{58}{subsection.C.2} -\contentsline {section}{\numberline {D}Glossary}{60}{section.D} -\contentsline {section}{\numberline {E}GNU Free Documentation License}{61}{section.E} +\contentsline {section}{\numberline {D}Glossary}{60}{appendix.D} +\contentsline {section}{\numberline {E}GNU Free Documentation License}{61}{appendix.E} \contentsline {subsection}{1. APPLICABILITY AND DEFINITIONS}{61}{section*.3} \contentsline {subsection}{2. VERBATIM COPYING}{62}{section*.3} \contentsline {subsection}{3. COPYING IN QUANTITY}{62}{section*.3} diff --git a/doc/manual/LedgerSMB-manual.txt b/doc/manual/LedgerSMB-manual.txt index b667373e..317ac4c7 100644 --- a/doc/manual/LedgerSMB-manual.txt +++ b/doc/manual/LedgerSMB-manual.txt @@ -1,4 +1,4 @@ -TITLE: Ledger-SMB Manual v. 1.2 +TITLE: LedgerSMB Manual v. 1.2 AUTHOR: The LedgerSMB Core Team The LedgerSMB Core Team @@ -18,24 +18,24 @@ the license is included in the section entitled -PART: Ledger-SMB and Business Processes +PART: LedgerSMB and Business Processes -Ledger-SMB and Business Processes +LedgerSMB and Business Processes -SECTION: Introduction to Ledger-SMB +SECTION: Introduction to LedgerSMB -Introduction to Ledger-SMB +Introduction to LedgerSMB -SUBSECTION: Why Ledger-SMB +SUBSECTION: Why LedgerSMB -Why Ledger-SMB +Why LedgerSMB -SUBSUBSECTION: Advantages of Ledger-SMB +SUBSUBSECTION: Advantages of LedgerSMB -Advantages of Ledger-SMB +Advantages of LedgerSMB Flexibility and Central Management Accessibility over the Internet (for some users) @@ -93,7 +93,7 @@ Key Features Users can have localized systems independent of company data set Point of Sale - Run multiple cash registers against main Ledger-SMB installation + Run multiple cash registers against main LedgerSMB installation Suitable for retail stores and more Credit card processing via TrustCommerce Supports some POS hardware out of the box including: @@ -121,18 +121,18 @@ reports using third party reporting tools. Flexible framework allows one to customize reports to change the tax reporting framework to meet any local requirement. -SUBSECTION: Limitations of Ledger-SMB +SUBSECTION: Limitations of LedgerSMB -Limitations of Ledger-SMB +Limitations of LedgerSMB No payroll module (Payroll must be done manually) Some integration limitations Further development/maintenance requires a knowledge of a relatively broad range of technologies -SUBSECTION: System Requirements of Ledger-SMB +SUBSECTION: System Requirements of LedgerSMB -System Requirements of Ledger-SMB +System Requirements of LedgerSMB PostgreSQL A CGI-enabled Web Server (for example, Apache) @@ -166,14 +166,14 @@ SECTION: User Account and Database Administration Basics User Account and Database Administration Basics These functions are accessed via the admin.pl script in the -installed directory of Ledger-SMB. +installed directory of LedgerSMB. SUBSECTION: Companies and Datasets Companies and Datasets -Ledger-SMB stores its information in locale-specific data sets. When +LedgerSMB stores its information in locale-specific data sets. When a dataset is created, it sets various defaults such as currency, a basic chart of accounts setup, and so forth. Note that the default setup is for Canada, where the author of the software resides. @@ -184,7 +184,7 @@ one company. If a customer is working with multiple companies, he/she must create a dataset to for each. When creating a dataset, the application asks for both a username and a -superusername. If the superuser's information is not filled in, Ledger-SMB will +superusername. If the superuser's information is not filled in, LedgerSMB will attempt to populate an existing dataset, but if this information is filled in, the program will log into the PostgreSQL cluster with the superusername and password, create the database, and attempt to add Plpgsql to it. @@ -204,7 +204,7 @@ SUBSECTION: Permissions Permissions -The permissions system is not rigorously enforced within Ledger-SMB, +The permissions system is not rigorously enforced within LedgerSMB, in the sense that the permissions API is generally not used in the application itself. Instead permissions are used to enable/disable menu options. Setting an enforcement of such permissions would require @@ -420,7 +420,7 @@ SUBSECTION: General Guidelines on Numbering Accounts General Guidelines on Numbering Accounts -In general, most drop-down boxes in Ledger-SMB order the accounts +In general, most drop-down boxes in LedgerSMB order the accounts by account number. Therefore by setting appropriate account numbers, one can affect the default values. @@ -460,7 +460,7 @@ SECTION: Administration Administration This section covers other (non-Chart of Accounts) aspects to the -setup of the Ledger-SMB accounting package. These are generally accessed +setup of the LedgerSMB accounting package. These are generally accessed in the System submenu. @@ -597,7 +597,7 @@ numbers. This was meant to ensure that one did not erase data from the accounting books (and as such that erasing data would be a sign of foul play). -Ledger-SMB has a capability to require such reversals if the business +LedgerSMB has a capability to require such reversals if the business deems this to be necessary. When this option is enabled, existing transactions cannot be modified and one will need to post reversing transactions to void existing transactions before posting corrected @@ -634,7 +634,7 @@ Departments Departments are logical divisions of a business. They allow for budgets to be prepared for the individual department as well as the business -as a whole. This allows larger businesses to use Ledger-SMB to meet +as a whole. This allows larger businesses to use LedgerSMB to meet their needs. @@ -649,14 +649,14 @@ gain money. For example, the legal department in most companies is a cost center. One of the serious misunderstandings people run up against is that -Ledger-SMB tends to more narrowly define cost and profit centers than -most businesses do. In Ledger-SMB a cost center is any department +LedgerSMB tends to more narrowly define cost and profit centers than +most businesses do. In LedgerSMB a cost center is any department of the business that does not issue AR transactions. Although many businesses may have cost centers (like technical support) where customer -fees may subsidize the cost of providing the service, in Ledger-SMB, +fees may subsidize the cost of providing the service, in LedgerSMB, these are profit centers. -Ledger-SMB will not allow cost centers to be associated with AR transactions. +LedgerSMB will not allow cost centers to be associated with AR transactions. So if you want this functionality, you must create the department as a profit center. @@ -665,7 +665,7 @@ SUBSECTION: Warehouses Warehouses -Ledger-SMB has the ability to track inventory by warehouse. Inventory +LedgerSMB has the ability to track inventory by warehouse. Inventory items can be moved between warehouses, and shipped from any warehouse where the item is in stock. We will explore this concept more later. @@ -722,7 +722,7 @@ SUBSUBSECTION: Overview of Template Editing Overview of Template Editing The templates for invoices, orders, and the like can be edited from -within Ledger-SMB. The submenus within the System submenu such as +within LedgerSMB. The submenus within the System submenu such as HTML Templates, Text Templates and templates provide access to this functionality. @@ -731,7 +731,7 @@ SUBSUBSECTION: Year-end Year-end -Although the Year-end functionality in Ledger-SMB is very useful, +Although the Year-end functionality in LedgerSMB is very useful, it does not entirely make the process simple and painless. One must still manually enter adjustments prior to closing the books. The extent to which these adjustments are necessary for any given business is @@ -751,7 +751,7 @@ of the amount invested in a business, but any dividends ought not to count against their recipients when new investors are brought on board. -Ledger-SMB automatically moves all income and expense into the specified +LedgerSMB automatically moves all income and expense into the specified year-end/retained earnings account. It does not move the drawing account, and this must be done manually, nor does it automate the process of making adjustments. @@ -760,11 +760,11 @@ Contrary to its name, this function can close the books at any time, though this would likely be of limited use. -SUBSECTION: Options in the ledger-smb.conf +SUBSECTION: Options in the ledgersmb.conf -Options in the ledger-smb.conf +Options in the ledgersmb.conf -The ledger-smb.conf configures the software by assigning site-wide +The ledgersmb.conf configures the software by assigning site-wide variables. Most of these should be left alone unless one knows what one is doing. However, on some systems some options might need to be changed, so all options are presented here for reference: @@ -774,7 +774,7 @@ be changed, so all options are presented here for reference: email from standard input. [language] allows one to set the language for the login screen and admin page. -[latex] tells Ledger-SMB whether is installed. is +[latex] tells LedgerSMB whether is installed. is required for generating Postscript and PDF invoices and the like. [Environmental variables] can be set here too. One can add paths for searching for , etc. @@ -884,7 +884,7 @@ SUBSECTION: Assemblies and Manufacturing Assemblies and Manufacturing Manufacturers order parts but they sell the products of their efforts. -Ledger-SMB supports manufacturing using the concept of assemblies. +LedgerSMB supports manufacturing using the concept of assemblies. An assembly is any product which is manufactured on site. It consists of a selection of parts, services, and/or labor and overhead. Assemblies are treated as parts in most other regards. @@ -901,7 +901,7 @@ One stocks assemblies in the Stock Assembly entry on the Goods and Services submenu. When an assembly is stocked the inventory is adjusted properly. -The Check Inventory option will cause Ledger-SMB to refuse to stock +The Check Inventory option will cause LedgerSMB to refuse to stock an assembly if the inventory required to produce the assembly would drop the part below the reorder point. @@ -1080,7 +1080,7 @@ The AP Invoice section has a capacity to separate internal notes from notes printed on the invoice. Note, however, that since these are received invoices, it is rare that one needs this ability. -Note that Ledger-SMB can search for partial part numbers or descriptions. +Note that LedgerSMB can search for partial part numbers or descriptions. Also if you have a group you can use this to select the part. @@ -1344,7 +1344,7 @@ Project Basics A project is a logical collection of AR and AP transactions, orders, and the like that allow one to better manage specific service or product -offerings. Ledger-SMB does not offer comprehensive project management +offerings. LedgerSMB does not offer comprehensive project management capabilities, and projects are only used here as they relate to accounting. One can also add translated descriptions to the project names as well. @@ -1418,7 +1418,7 @@ SECTION: Quotations and Order Management Quotations and Order Management -This unit will introduce the business processes that Ledger-SMB allows. +This unit will introduce the business processes that LedgerSMB allows. These processes are designed to allow various types of businesses to manage their orders and allow for rudimentary customer relationship management processes to be built around this software. In this section, @@ -1803,7 +1803,7 @@ SUBSECTION: GL Basics GL Basics -The General Ledger is the heart of Ledger-SMB. Indeed, Ledger-SMB +The General Ledger is the heart of LedgerSMB. Indeed, LedgerSMB is designed to be as close as possible to a software equivalent of a paper-based accounting program (but with no difference between the General Ledger and General Journal). @@ -1878,9 +1878,9 @@ DATE & EXPLANATION & REF. & DEBITS & DATE & EXPLANATION & REF. & CREDITS -SUBSUBSECTION: The GL in Ledger-SMB +SUBSUBSECTION: The GL in LedgerSMB -The GL in Ledger-SMB +The GL in LedgerSMB The paper-based accounting procedure works well when one is stuck with paper recording requirements but it has one serious deficiency--- @@ -1892,11 +1892,11 @@ way a General Journal is used in the paper-based systems and then present the same information in ways which are more closely related to the General Ledger book. -This is the exact way that the General Ledger is used in Ledger-SMB. +This is the exact way that the General Ledger is used in LedgerSMB. The actual data is entered and stored as if it was a general journal, and then the data can be presented in any number of different ways. -All modules of Ledger-SMB that involve COA accounts store their data +All modules of LedgerSMB that involve COA accounts store their data in the General Ledger (it is a little more complex than this but this is very close to the actual mechanism). @@ -1905,7 +1905,7 @@ SUBSECTION: Cash Transfer Cash Transfer -The simplest form of GL entry in Ledger-SMB is the Cash- +The simplest form of GL entry in LedgerSMB is the Cash- Transfer screen. This screen shows two transaction lines, and fields for reference, department, description, and notes. @@ -2001,7 +2001,7 @@ SUBSECTION: Reports Reports -The most flexible report in Ledger-SMB is the GL report because it +The most flexible report in LedgerSMB is the GL report because it has access to the entire set of financial transactions of a business. Every invoice posted, payment made or received, etc. can be located here. @@ -2046,7 +2046,7 @@ intervals. To schedule any GL, AR, or AP transaction or invoice, click the schedule button. In general the reference number should be left blank as this will -force Ledger-SMB to create a new invoice or transaction number for +force LedgerSMB to create a new invoice or transaction number for each iteration. The rest of the options are self-explanatory. Note that a blank number if iterations will result in no recurrences of the transaction. @@ -2147,7 +2147,7 @@ What if the Trial Balance doesn't Balance? If the trial balance does not balance, get technical support immediately. This usually means that transactions were not entered properly. Some may have been out of balance, or some may have gone into non-existent -accounts (believe it or not, Ledger-SMB does not check this latter +accounts (believe it or not, LedgerSMB does not check this latter issue). @@ -2227,7 +2227,7 @@ SUBSECTION: Balance Sheet Balance Sheet The balance sheet is the second major accounting statement supported -by Ledger-SMB. The balance sheet provides a snapshot of the current +by LedgerSMB. The balance sheet provides a snapshot of the current financial health of the business by comparing assets, liabilities, and equity. @@ -2273,7 +2273,7 @@ SUBSECTION: No Statement of Owner Equity? No Statement of Owner Equity? The Statement of Owner Equity is the one accounting statement that -Ledger-SMB does not support. However, it can be simulated by running +LedgerSMB does not support. However, it can be simulated by running a balance sheet at the end of the time frame in question and comparing it to the beginning. One can check this against an income statement for the period in question to verify its accuracy. The statement of @@ -2284,7 +2284,7 @@ SECTION: The Template System The Template System -Ledger-SMB allows most documents to be generated according to a template +LedgerSMB allows most documents to be generated according to a template system. This allows financial statements, invoices, orders, and the like to be customized to meet the needs of most businesses. Company logos can be inserted, the format can be radically altered, one can @@ -2313,7 +2313,7 @@ The first two lines are: -The first line tells Ledger-SMB to print the company name as passed +The first line tells LedgerSMB to print the company name as passed to it via a variable, centered, with a page width of 40 characters. The second line does the same thing with the address. @@ -2468,8 +2468,8 @@ How are They Stored in the Filesystem? The template directory (` "templates`\" in the root -Ledger-SMB install directory) contains all the root templates used -by Ledger-SMB. These follow a naming convention of COAType-templatename.ext +LedgerSMB install directory) contains all the root templates used +by LedgerSMB. These follow a naming convention of COAType-templatename.ext where COAType is the type of dataset that was created when the user was created, templatename is the name of the template, and ext is either txt, html, or tex (for text, html, and @@ -2478,7 +2478,7 @@ either txt, html, or tex (for text, html, and Inside this directory are one or more subdirectories where the relevant templates have been copied as default language templates for the user. Many users can use the same user directory (which bears the name of -the Ledger-SMB username). Within this directory are more subdirectories +the LedgerSMB username). Within this directory are more subdirectories for translated templates, one for each language created. @@ -2486,7 +2486,7 @@ SUBSECTION: Upgrade Issues Upgrade Issues -When Ledger-SMB is upgraded, the templates are not replaced. This +When LedgerSMB is upgraded, the templates are not replaced. This is designed to prevent the upgrade script from overwriting changes made during the course of customizing the templates. @@ -2510,7 +2510,7 @@ SUBSECTION: Preliminaries Preliminaries -Logging into Ledger-SMB (1.2+) updates a row in the users table +Logging into LedgerSMB (1.2+) updates a row in the users table containing your account configuration defaults and other information. The implication for API users of LSMB is that you must login as part of running API scripts. For security purposes, it is recommended that @@ -2521,21 +2521,21 @@ directory. Consider a simple example: - cd /usr/local/ledger-smb + cd /usr/local/ledgersmb ./ct.pl "login=name &path=bin\&password=xxxxx\&action=search\&db=customer" The cd command moves your terminal session's current working directory into -the main Ledger-SMB directory. Then the Ledger-SMB perl script ct.pl is called +the main LedgerSMB directory. Then the LedgerSMB perl script ct.pl is called with one long line as an argument. The argument is really several variable=value pairs separated by ampersands ( &). The value for the login variable is the username -that Ledger-SMB is to use, and the value for the password variable is the plaintext password. +that LedgerSMB is to use, and the value for the password variable is the plaintext password. To build our examples we will use a username of "clarkkent" who has a password of "lOis,lAn3". - cd /usr/local/ledger-smb + cd /usr/local/ledgersmb ./ct.pl "login=clarkkent &path=bin\&password=lOis,lAn3\&action=search\&db=customer" @@ -2554,14 +2554,14 @@ to do some useful work. This is a bash script which: 1. sets NOW to the current working directory - 2. prompts for and reads your Ledger-SMB login - 3. prompts for and reads (non-echoing) your Ledger-SMB password - 4. changes directory to /usr/local/ledger-smb + 2. prompts for and reads your LedgerSMB login + 3. prompts for and reads (non-echoing) your LedgerSMB password + 4. changes directory to /usr/local/ledgersmb 5. constructs login and logout commands and a transaction command - 6. logins into ledger-smb (in a real program, output would be checked for + 6. logs into ledgersmb (in a real program, output would be checked for success or failure) 7. executes the transaction - 8. logs out of ledger-smb (although this is not necessary) + 8. logs out of ledgersmb (although this is not necessary) 9. returns to the original working directory 10. exits @@ -2570,9 +2570,9 @@ Running lsmb01-cli-example.sh produces: $ lsmb01-cli-example.sh -Ledger-SMB login: clarkkent +LedgerSMB login: clarkkent -Ledger-SMB password: +LedgerSMB password: <body> @@ -2622,11 +2622,11 @@ Script 1 (Bash) NOW=`pwd` -echo -n "Ledger-SMB login: " +echo -n "LedgerSMB login: " read LSLOGIN echo -echo -n "Ledger-SMB password: " +echo -n "LedgerSMB password: " stty -echo read LSPWD stty echo @@ -2637,7 +2637,7 @@ ARG="login=$LSLOGIN&password=$LSPWD&path=bin&action=search&db=customer" LGIN="login=$LSLOGIN&password=$LSPWD&path=bin&action=login" LGOT="login=$LSLOGIN&password=$LSPWD&path=bin&action=logout" -cd /usr/local/ledger-smb +cd /usr/local/ledgersmb ./login.pl $LGIN 2>&1 > /dev/null ./ct.pl $ARG @@ -2659,9 +2659,9 @@ above, though it is still fairly limited. If your needs require, rather than hav the script build and then execute the commands it could be written to generate a shell script which is executed by hand. -This script begins by prompting for your Ledger-SMB login and password. Using +This script begins by prompting for your LedgerSMB login and password. Using the supplied values a login command is constructed and passed into the runLScmd -subroutine. runLScmd changes directory to /usr/local/ledger-smb/ for the length +subroutine. runLScmd changes directory to /usr/local/ledgersmb/ for the length of the subroutine. It formats the command and executes it and returns both the output and error information to the caller in a scalar. @@ -2680,7 +2680,7 @@ Script 2 (Perl) #!/usr/bin/perl -w # # File: lsmb02-cli-example.pl -# Environment: Ledger-SMB 1.2.0+ +# Environment: LedgerSMB 1.2.0+ # Author: Louis B. Moore # # Copyright (C) 2006 Louis B. Moore @@ -2795,7 +2795,7 @@ sub runLScmd my $i = 0; my $results; - local $CWD = "/usr/local/ledger-smb/"; + local $CWD = "/usr/local/ledgersmb/"; $cmd = $cmd . " "" . $args . "\""; @@ -2848,7 +2848,7 @@ SECTION: Basic Architecture Basic Architecture -Ledger-SMB is a web-based Perl program that interfaces with PostgreSQL +LedgerSMB is a web-based Perl program that interfaces with PostgreSQL using the relevant Perl modules. The code is well partitioned, and the main operation modules are written in an object oriented way. @@ -2861,30 +2861,30 @@ The Software Stack fig-sl-stack sl-stack.tex -CAPTION: The Ledger-SMB software stack in a Typical Implementation +CAPTION: The LedgerSMB software stack in a Typical Implementation -The Ledger-SMB software stack in a Typical Implementation +The LedgerSMB software stack in a Typical Implementation -Ledger-SMB runs in a Perl interpreter. I do not currently know if +LedgerSMB runs in a Perl interpreter. I do not currently know if it is possible to run it with Perl2C or other language converters to run in other environments. However, except for high-capacity environments, Perl is a good language choice for this sort of program. -Ledger-SMB used to support DB2 and Oracle as well as PostgreSQL. However, +LedgerSMB used to support DB2 and Oracle as well as PostgreSQL. However, currently some of the functionality is implemented using PostgreSQL user-defined functions. These would need to be ported to other database managers in order to make the software work on these. It should not be too hard, but the fact that it has not been done yet may mean that there is no real demand for running the software under other RDBMS's. -One can substitute other web servers for Apache. Normally Ledger-SMB +One can substitute other web servers for Apache. Normally LedgerSMB is run as a CGI program but it may be possible to run it in the web server process (note that this may not be entirely thread-safe). The operating system can be any that supports a web server and Perl (since PostgreSQL need not run on the same system). However, there -are a few issues running Ledger-SMB on Windows (most notably in trying +are a few issues running LedgerSMB on Windows (most notably in trying to get Postscript documents to print properly). On the client side, any web-browser will work. Currently, the layout @@ -2898,14 +2898,14 @@ SUBSECTION: Capacity Planning Capacity Planning -Some companies may ask how scalable Ledger-SMB is. In general, it +Some companies may ask how scalable LedgerSMB is. In general, it is assumed that few companies are going to have a need for a high-concurrency -accounting system. However, with all the features available in Ledger-SMB, +accounting system. However, with all the features available in LedgerSMB, the staff that may have access to some of the application may be senior enough to make the question worthwhile. This question also becomes more important when companies might look -at integrating Ledger-SMB with a CRM solution, online store, or other +at integrating LedgerSMB with a CRM solution, online store, or other environment. This section looks at a number of the known issues and their solutions. @@ -2914,15 +2914,15 @@ SUBSUBSECTION: Scalability Strategies Scalability Strategies -Ledger-SMB is a fairly standard web-based application. However, +LedgerSMB is a fairly standard web-based application. However, sometimes the database schema changes during upgrades. In these cases, it becomes impossible to use different versions of the software against -the same database version safely. Ledger-SMB checks the version of +the same database version safely. LedgerSMB checks the version of the database and if the version is higher than the version of the software that is running, will refuse to run. Therefore although one strategy might be to run several front-end -web servers with Ledger-SMB, in reality this can be a bit of a problem. +web servers with LedgerSMB, in reality this can be a bit of a problem. One solution is to take half of the front-end servers off-line while doing the initial upgrade, and then take the other offline to upgrade when these are brought back online. @@ -2938,7 +2938,7 @@ be able to move staff who do not need real-time access to new entries onto a PG-Pool/Slony-I cluster where new transactions are entered on the master and other data is looked up on the replica. In certain circumstances, one can also offload a number of other queries from -the master database in order to minimize the load. Ledger-SMB has +the master database in order to minimize the load. LedgerSMB has very few issues in the scalability of the application. @@ -2955,7 +2955,7 @@ those old rows are removed, performance can degrade as PostgreSQL has to search through all the old versions of the row in order to determine which one ought to be the current one. -Due to the way the SQL statements are executed in Ledger-SMB, most +Due to the way the SQL statements are executed in LedgerSMB, most inserts will also create a dead row. A second problem occurs in that each transaction is given a transaction @@ -3017,7 +3017,7 @@ SECTION: Customization Possibilities Customization Possibilities -Ledger-SMB is designed to be customized relatively easily and rapidly. +LedgerSMB is designed to be customized relatively easily and rapidly. In general, the source code is well written and compartmentalized. This section covers the basic possibilities involving customization. @@ -3026,13 +3026,13 @@ SUBSECTION: Brief Guide to the Source Code Brief Guide to the Source Code -Ledger-SMB is an application with over 34000 lines of code. While +LedgerSMB is an application with over 34000 lines of code. While it is not possible to cover the entire application here, a brief overview of the source code is in order. In the root of the install directory, one will find a setup.pl program, a number of other .pl programs, and a number of directories. The setup.pl -program is used to update or install Ledger-SMB. The other .pl programs +program is used to update or install LedgerSMB. The other .pl programs provide a basic set of services for the framework (including authentication) and then pass the work on to the data entry screen file in the bin directory. @@ -3048,12 +3048,12 @@ The css directory in the root install directory contains CSS documents to provide various stylesheets one can select for changing various aspects of the look and feel of the application. -The locale directory contains translation files that Ledger-SMB uses +The locale directory contains translation files that LedgerSMB uses to translate between different languages. One could add translations to these files if necessary. The LSMB directory is where the Perl modules reside that provide the -core business logic in Ledger-SMB. These modules provide functionality +core business logic in LedgerSMB. These modules provide functionality such as form handling, email capabilities, and access to the database through its at least partially object oriented API. @@ -3078,7 +3078,7 @@ on the last partnumber field, removed separate print and post buttons to ensure that invoices were always printed and posted together, and removed the ability to print to the screen, and even the ability to scan items in when an invoice was received (using a portable data -terminal) and import this data into Ledger-SMB. Finally we added the +terminal) and import this data into LedgerSMB. Finally we added the ability to reconcile the till online in a paperless manner. For another customer, we added the ability to print AR invoices in @@ -3132,9 +3132,9 @@ SUBSECTION: Reports Reports The fact that all the data is available within the database manager -is a huge advantage of Ledger-SMB over Quickbooks and the like. The +is a huge advantage of LedgerSMB over Quickbooks and the like. The rapid development of reports allows for one to easily develop reports -of any sort within Ledger-SMB. +of any sort within LedgerSMB. SUBSUBSECTION: Examples @@ -3160,7 +3160,7 @@ SUBSECTION: Reporting Tools Reporting Tools Any reporting tool which can access the PostgreSQL database can be -used with Ledger-SMB for custom reporting. These can include programs +used with LedgerSMB for custom reporting. These can include programs like Microsoft Access and Excel (using the ODBC drivers), PgAccess (A PostgreSQL front-end written in TCL/Tk with a similar feel to Access), Rekall, Crystal Reports, OpenOffice and more. @@ -3175,7 +3175,7 @@ used the ODBC driver to import these into Excel. Excel can also read HTML tables, so one can use PostgreSQL to create an HTML table of the result and save it with a .xls extension so that Windows opens it with Excel. These could then be served via the same web server -that serves Ledger-SMB. +that serves LedgerSMB. SUBSECTION: Line of Business Tools on PostgreSQL @@ -3185,7 +3185,7 @@ Line of Business Tools on PostgreSQL Various line of business tools have been written using PostgreSQL in large part due to the fact that it is far more mature than MySQL in areas relating to data integrity enforcement, transactional processing, -and the like. These tools can be integrated with Ledger-SMB in various +and the like. These tools can be integrated with LedgerSMB in various ways. One could integrate this program with the HERMES CRM framework, for example. @@ -3194,7 +3194,7 @@ SUBSUBSECTION: Known Issues Known Issues -Ledger-SMB uses a single 'id' sequence across many tables. At the +LedgerSMB uses a single 'id' sequence across many tables. At the same time it is expected that these tables do not have identical id values in their records as they are used as a sort of pseudo-foreign key by the acc table which stores the financial transaction @@ -3215,13 +3215,13 @@ from integration in the same database but under different schemas. This allows PostgreSQL to become the main method of synchronizing the data in real time. However, sometimes this can require dumping the database, recreating the tables etc. in a different schema and -importing the data back into Ledger-SMB. +importing the data back into LedgerSMB. One possibility for this sort of integration is to use database triggers to replicate the data between the applications in real-time. This can avoid the main issue of duplicate id's. One issue that can occur however relates to updates. If one updates a customer record in HERMES, -for example, how do we know which record to update in Ledger-SMB? +for example, how do we know which record to update in LedgerSMB? There are solutions to this problem but they do require some forethought. A second possibility is to use views to allow one application to present @@ -3234,9 +3234,9 @@ SUBSUBSECTION: Examples Examples -Others have integrated L'ane POS and Ledger-SMB in order to make it +Others have integrated L'ane POS and LedgerSMB in order to make it work better with touch screen devices. Still others have successfully -integrated Ledger-SMB and Interchange. In both cases, I believe that +integrated LedgerSMB and Interchange. In both cases, I believe that triggers were used to perform the actual integration. @@ -3244,7 +3244,7 @@ SUBSECTION: Line of Business Tools on other RDBMS's Line of Business Tools on other RDBMS's -Often there are requests to integrate Ledger-SMB with applications +Often there are requests to integrate LedgerSMB with applications like SugarCRM, OSCommerce, and other applications running on MySQL or other database managers. This is a far more complex field and it requires a great deal more effort than integrating applications within @@ -3267,7 +3267,7 @@ In general, it is usually advisable to add two fields to the record-- one that shows the insert time and one that shows the last update. Additionally, I would suggest adding additional information to the -Ledger-SMB tables so that you can track the source record from the +LedgerSMB tables so that you can track the source record from the other application in the case of an update. In general, one must write replication scripts that dump the information @@ -3311,7 +3311,7 @@ as instantiating the form object, ensuring that the user is logged in, and the like. They then pass the execution off to the user interface script (usually in the bin/mozilla directory). -Ledger-SMB in many ways may look sort of object oriented in its design, +LedgerSMB in many ways may look sort of object oriented in its design, but in reality, it is far more data-driven than object oriented. The Form object is used largely as a global symbol table and also as a collection of fundamental routines for things like database access. @@ -3329,7 +3329,7 @@ SUBSECTION: Customizing Templates Customizing Templates Templates are used to generate printed checks, invoices, receipts, -and more in Ledger-SMB. Often the format of these items does not fit +and more in LedgerSMB. Often the format of these items does not fit a specific set of requirements and needs to be changed. This document will not include or HTML instruction, but will include a general introduction to editing templates. Also, this is not intended @@ -3413,7 +3413,7 @@ the object to another page). In this case you will need to use three passes of in order to have accurate references. -Ledger-SMB as of the time of this writing (2.6.8) only makes one pass +LedgerSMB as of the time of this writing (2.6.8) only makes one pass at the file. To force it to make more than one pass, open Form.pm with your favorite text editor. Look for the line: @@ -3449,7 +3449,7 @@ SUBSECTION: Customizing Forms Customizing Forms Data entry forms and other user interface pieces are in the bin directory. -In Ledger-SMB 1.0.0 and later, symlinks are not generally used. +In LedgerSMB 1.0.0 and later, symlinks are not generally used. Each module is identified with a two letter combination: ar, ap, cp, etc. These combinations are generally explained in the comment headers @@ -3531,7 +3531,7 @@ SECTION: Where to Go for More Information Where to Go for More Information -There are a couple of relevant sources of information on Ledger-SMB +There are a couple of relevant sources of information on LedgerSMB in particular. The most important resources are the LedgerSMB web site @@ -3539,7 +3539,7 @@ The most important resources are the LedgerSMB web site site. In addition, it is generally recommended that the main bookkeeper -of a company using Ledger-SMB work through at least one accounting +of a company using LedgerSMB work through at least one accounting textbook. Which textbook is not as important as the fact that a textbook is used. @@ -3588,7 +3588,7 @@ SUBSECTION: Common Installation Errors Common Installation Errors - Ledger-SMB is generally best installed in its own directory outside + LedgerSMB is generally best installed in its own directory outside of the wwwroot directory. While it is possible to install it inside the wwwroot directory, the instructions and the faq don't cover the common problems here. @@ -3605,7 +3605,7 @@ Retail With Light Manufacturing For purposes of this example we will use a business that assembles computers and sells them on a retail store. - Install Ledger-SMB. + Install LedgerSMB. Set preferences, and customize chart of accounts. Before customizing the COA it is suggested that you consult an accountant. @@ -3654,11 +3654,11 @@ fields are filled out and the buttons are used at the bottom to save the record and optionally use it to create an invoice, etc. Saving a customer returns to the customer screen. After the appropriate -invoice, transaction, etc. is entered and posted, Ledger-SMB will +invoice, transaction, etc. is entered and posted, LedgerSMB will return to the add customer screen. One can use the requirements report to help determine what parts need to be ordered though one cannot generate PO's directly from this report. -Note, the needs of Ledger-SMB are mostly useful for light manufacturing +Note, the needs of LedgerSMB are mostly useful for light manufacturing operations (assembling computers, for example). More manufacturing capabilities are expected to be released in the next version. |