From 34018eb55727959f2df71283bc3a7159b312e885 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Jan=20Posp=C3=AD=C5=A1il?= <honik@ntc.zcu.cz>
Date: Thu, 11 Dec 2008 09:58:08 +0000
Subject: [PATCH] TODOs from hands-on

---
 org.glite.lb.doc/src/LBDG-Introduction.tex | 11 +++++++++--
 org.glite.lb.doc/src/consumer_api.tex      |  2 +-
 org.glite.lb.doc/src/producer_api.tex      | 15 +++++++++++----
 3 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/org.glite.lb.doc/src/LBDG-Introduction.tex b/org.glite.lb.doc/src/LBDG-Introduction.tex
index a689737..6145130 100644
--- a/org.glite.lb.doc/src/LBDG-Introduction.tex
+++ b/org.glite.lb.doc/src/LBDG-Introduction.tex
@@ -54,6 +54,11 @@ in a programming language (though it is possible), they might be useful rather i
 scripts. Their usage is rather straightforward as it is described in the User's Guide \cite{lbug}.
 
 
+\subsection{Building Client Libraries}
+\TODO{ljocha}
+
+
+
 \subsection{General Guidelines}
 
 \marginpar{Naming conventions}%
@@ -151,6 +156,8 @@ operation). The connections are transparently shared and reused by all
 contexts/threads to eliminate the overhead of secure channel
 establishment. This behaviour is completely hidden by the library.
 
+
+
 \section{\LB Common Components}
 \label{s:common}
 
@@ -239,7 +246,7 @@ free(cert_file);
 The third argument points at variable with type corresponding to the
 requested parameter. Do not forget to free the result.
 
-\TODO{Máme odkaz kde jsou popsany defaulty a vazby na promenne environmentu?}
+\TODO{sitera: Mame odkaz kde jsou popsany defaulty a vazby na promenne environmentu (ty jsou v LBUG Appendix C)}
 
 \marginpar{Obtaining error details}%
 When \LB API call returns error, additional details can be obtained
@@ -471,7 +478,7 @@ in memory only once.
 \marginpar{Context}%
 The context in C API is part of common components, the C++ API on the
 other hand differentiates between query context
-(see~\ref{ServerConnection}) and logging context; the description is
+(see Section~\ref{s:ServerConnection}) and logging context; the description is
 therefore part of the respective chapters.
 
 \subsubsection{Header Files}
diff --git a/org.glite.lb.doc/src/consumer_api.tex b/org.glite.lb.doc/src/consumer_api.tex
index e5c7b30..e7066d4 100644
--- a/org.glite.lb.doc/src/consumer_api.tex
+++ b/org.glite.lb.doc/src/consumer_api.tex
@@ -308,7 +308,7 @@ demonstrated in the client example \texttt{job\_log.c} (in the client module).
 
 \subsection{C++ Language Binding}
 \subsubsection{Header Files}
-\subsubsection{ServerConnection}
+\subsubsection{ServerConnection}\label{s:ServerConnection}
 \subsubsection{Job}
 \subsubsection{JobStatus}
 
diff --git a/org.glite.lb.doc/src/producer_api.tex b/org.glite.lb.doc/src/producer_api.tex
index 214c22b..cddee60 100644
--- a/org.glite.lb.doc/src/producer_api.tex
+++ b/org.glite.lb.doc/src/producer_api.tex
@@ -8,7 +8,8 @@ The \LB\ logging API (or producer API) is used to create and deliver
 events to the \LB\ server and/or proxy, depending on the function
 used:
 
-\TODO{verify ChangeACL}
+\TODO{kouril: verify ChangeACL}
+
 \begin{table}[h]
 \begin{tabularx}{\textwidth}{lX}
 \bf Function & \bf Delivers to \\
@@ -124,7 +125,7 @@ extern int edg_wll_SetLoggingJob(
 After setting the logging job identity, all the following logging
 calls refer to this \jobid and the sequence code is incremented
 according to the source component.
-\TODO{how is the sequence code updated?}
+\TODO{honik: how is the sequence code updated?}
 
 \subsubsection{Return values}
 The logging functions return 0 on success and one of \texttt{EINVAL,
@@ -134,7 +135,7 @@ it is not guaranteed, however, that the event was not delivered by the
 first call. Possibly duplicated events are discarded by the \LB\
 server or proxy.
 
-\TODO{check these}
+\TODO{ljocha: check these}
 The synchronous variants of logging functions can in addition return
 \verb'EDG_WLL_ERROR_NOJOBID' or \verb'EDG_WLL_ERROR_DB_DUP_KEY'.
 
@@ -148,7 +149,7 @@ First we have to include neccessary headers:
 Initialize context and set parameters:
 \lstinputlisting[title={\bf File: }\lstname,numbers=left,linerange=context-end\ context]{prod_example1.c}
 
-\TODO{proper setting of sequence codes}
+\TODO{honik: proper setting of sequence codes}
 \lstinputlisting[title={\bf File: }\lstname,numbers=left,linerange=sequence-end\ sequence]{prod_example1.c}
 
 Log the event:
@@ -172,6 +173,12 @@ write:
 err = edg_wll_LogUserTag(ctx, name, value);
 \end{lstlisting}
 
+
+\subsubsection{Change ACL example}
+\TODO{kouril}
+
+
+
 \subsection{Java binding}
 \TODO{mirek}
 
-- 
1.8.2.3