gnucash/libgnucash/engine/policy.h
Geert Janssens 83d14e1c1c Restructure the src directory
It is split into
- /libgnucash (for the non-gui bits)
- /gnucash (for the gui)
- /common (misc source files used by both)
- /bindings (currently only holds python bindings)

This is the first step in restructuring the code. It will need much
more fine tuning later on.
2017-08-10 18:45:00 +02:00

89 lines
3.6 KiB
C

/********************************************************************\
* policy.h -- Implement Accounting Policy *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of *
* the License, or (at your option) any later version. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License*
* along with this program; if not, contact: *
* *
* Free Software Foundation Voice: +1-617-542-5942 *
* 51 Franklin Street, Fifth Floor Fax: +1-617-542-2652 *
* Boston, MA 02110-1301, USA gnu@gnu.org *
\********************************************************************/
/** @addtogroup Engine
@{ */
/** @addtogroup Policy Accounting Policy (FIFO/LIFO)
* This file implements Accounting Policy. The Accounting Policy
* determines how Splits are assigned to Lots. The contents
* of a Lot determines the Gains on that Lot. The default policy
* is the FIFO policy: the first thing bought is also the first
* thing sold.
@{ */
/** @file policy.h
* @brief Implement Accounting Policy.
* @author Created by Linas Vepstas August 2003
* @author Copyright (c) 2003,2004 Linas Vepstas <linas@linas.org>
*/
#ifndef XACC_POLICY_H
#define XACC_POLICY_H
typedef struct gncpolicy_s GNCPolicy;
/** Valid Policy List
* Provides a glist of implemented policies.
*
* List must be freed with g_list_free().
*/
GList * gnc_get_valid_policy_list (void);
/** Valid Policy Name
* Uses the Valid Policy List to determine if a policy name is valid.
*/
gboolean gnc_valid_policy_name (const gchar *policy_name);
const char *PolicyGetName (const GNCPolicy *pcy);
const char *PolicyGetDescription (const GNCPolicy *pcy);
const char *PolicyGetHint (const GNCPolicy *pcy);
/** First-in, First-out Policy
* This policy will create FIFO Lots. FIFO Lots have the following
* properties:
* -- The lot is started with the earliest posted split that isn't
* a part of another lot already.
* -- Splits are added to the lot in date order, with earliest splits
* added first.
* -- All splits in the lot share the same transaction currency as
* the split that opened the lot (if book-currency book option
* selected, this will always be book currency).
*/
GNCPolicy *xaccGetFIFOPolicy (void);
/** Last-in, Last-out Policy
* This policy will create LIFO Lots. LIFO Lots have the following
* properties:
* -- The lot is started with the latest posted split that isn't
* a part of another lot already.
* -- Splits are added to the lot in date order, with latest splits
* added first.
* -- All splits in the lot share the same transaction currency as
* the split that opened the lot (if book-currency book option
* selected, this will always be book currency).
*/
GNCPolicy *xaccGetLIFOPolicy (void);
#endif /* XACC_POLICY_H */
/** @} */
/** @} */