From db769f667d93d9127b570570564589337c793fbe Mon Sep 17 00:00:00 2001
From: Aaron Griffin <aaron@archlinux.org>
Date: Sun, 15 Oct 2006 21:06:08 +0000
Subject: Added alpm function docs along pacman.c : Removed link to frugalware
 wiki sync.c : do not display Uncompressed size if 0 (archlinux has no USIZE)

---
 doc/man3/alpm_trans.3 | 141 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 141 insertions(+)
 create mode 100644 doc/man3/alpm_trans.3

(limited to 'doc/man3/alpm_trans.3')

diff --git a/doc/man3/alpm_trans.3 b/doc/man3/alpm_trans.3
new file mode 100644
index 00000000..d574cdb1
--- /dev/null
+++ b/doc/man3/alpm_trans.3
@@ -0,0 +1,141 @@
+.TH "Transaction Functions" 3 "16 Oct 2006" "libalpm" \" -*- nroff -*-
+.ad l
+.nh
+.SH NAME
+Transaction Functions \- Functions to manipulate libalpm transactions.  
+
+.PP
+.SS "Functions"
+
+.in +1c
+.ti -1c
+.RI "void * \fBalpm_trans_getinfo\fP (unsigned char parm)"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_init\fP (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_sysupgrade\fP ()"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_addtarget\fP (char *target)"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_prepare\fP (PMList **data)"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_commit\fP (PMList **data)"
+.br
+.ti -1c
+.RI "int \fBalpm_trans_release\fP ()"
+.br
+.in -1c
+.SH "Detailed Description"
+.PP 
+Functions to manipulate libalpm transactions. 
+.PP
+.SH "Function Documentation"
+.PP 
+.SS "int alpm_trans_addtarget (char * target)"
+.PP
+Add a target to the transaction. 
+.PP
+\fBParameters:\fP
+.RS 4
+\fItarget\fP the name of the target to add 
+.RE
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
+.SS "int alpm_trans_commit (PMList ** data)"
+.PP
+Commit a transaction. 
+.PP
+\fBParameters:\fP
+.RS 4
+\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) 
+.RE
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
+.SS "void* alpm_trans_getinfo (unsigned char parm)"
+.PP
+Get informations about the transaction. 
+.PP
+\fBParameters:\fP
+.RS 4
+\fIparm\fP name of the info to get 
+.RE
+.PP
+\fBReturns:\fP
+.RS 4
+a char* on success (the value), NULL on error 
+.RE
+.PP
+
+.SS "int alpm_trans_init (unsigned char type, unsigned int flags, alpm_trans_cb_event event, alpm_trans_cb_conv conv, alpm_trans_cb_progress progress)"
+.PP
+Initialize the transaction. 
+.PP
+\fBParameters:\fP
+.RS 4
+\fItype\fP type of the transaction 
+.br
+\fIflags\fP flags of the transaction (like nodeps, etc) 
+.br
+\fIevent\fP event callback function pointer 
+.br
+\fIconv\fP question callback function pointer 
+.br
+\fIprogress\fP progress callback function pointer 
+.RE
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
+.SS "int alpm_trans_prepare (PMList ** data)"
+.PP
+Prepare a transaction. 
+.PP
+\fBParameters:\fP
+.RS 4
+\fIdata\fP the address of a PM_LIST where detailed description of an error can be dumped (ie. list of conflicting files) 
+.RE
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
+.SS "int alpm_trans_release ()"
+.PP
+Release a transaction. 
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
+.SS "int alpm_trans_sysupgrade ()"
+.PP
+Search for packages to upgrade and add them to the transaction. 
+.PP
+\fBReturns:\fP
+.RS 4
+0 on success, -1 on error (pm_errno is set accordingly) 
+.RE
+.PP
+
-- 
cgit v1.2.3-70-g09d2