r7085 - in trunk/BOOK: . general/genutils introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sun Aug 19 05:39:33 PDT 2007


Author: randy
Date: 2007-08-19 06:39:33 -0600 (Sun, 19 Aug 2007)
New Revision: 7085

Added:
   trunk/BOOK/general/genutils/pinentry.xml
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/genutils/genutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Added new package PIN-Entry-0.7.3

Modified: trunk/BOOK/general/genutils/genutils.xml
===================================================================
--- trunk/BOOK/general/genutils/genutils.xml	2007-08-18 20:01:45 UTC (rev 7084)
+++ trunk/BOOK/general/genutils/genutils.xml	2007-08-19 12:39:33 UTC (rev 7085)
@@ -17,7 +17,8 @@
 
   <para>This chapter contains various utilities that do not fit conveniently into other
   chapters.  Programs include a command line calculator, several utilities for manipulating
-  text and graphics, and a program to interface with a palm-pilot.</para>
+  text and graphics, a program to interface with a palm-pilot and a program for entering
+  PIN numbers and pass-phrases.</para>
 
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bc.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rep-gtk.xml"/>
@@ -39,5 +40,6 @@
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="recode.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="icon-naming-utils.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rxvt-unicode.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pinentry.xml"/>
 
 </chapter>

Added: trunk/BOOK/general/genutils/pinentry.xml
===================================================================
--- trunk/BOOK/general/genutils/pinentry.xml	                        (rev 0)
+++ trunk/BOOK/general/genutils/pinentry.xml	2007-08-19 12:39:33 UTC (rev 7085)
@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY pinentry-download-http "http://ftp.gnupg.org/gcrypt/pinentry/pinentry-&pinentry-version;.tar.gz">
+  <!ENTITY pinentry-download-ftp  "ftp://ftp.gnupg.org/gcrypt/pinentry/pinentry-&pinentry-version;.tar.gz">
+  <!ENTITY pinentry-md5sum        "59282278405a8264b39ea28678c78cf4">
+  <!ENTITY pinentry-size          "417 KB">
+  <!ENTITY pinentry-buildsize     "9 MB">
+  <!ENTITY pinentry-time          "0.1 SBU">
+]>
+
+<sect1 id="pinentry" xreflabel="PIN-Entry-&pinentry-version;">
+  <?dbhtml filename="pinentry.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <title>PIN-Entry-&pinentry-version;</title>
+
+  <indexterm zone="pinentry">
+    <primary sortas="a-PIN-Entry">PIN-Entry</primary>
+  </indexterm>
+
+  <!--Required section-->
+  <sect2 role="package">
+    <title>Introduction to PIN-Entry</title>
+
+    <para>The <application>PIN-Entry</application> package contains a
+    collection of simple PIN or pass-phrase entry dialogs which utilize the
+    Assuan protocol as described by the
+    <ulink url="http://www.gnupg.org/aegypten/">&#xC4;egypten project</ulink>.
+    <application>PIN-Entry</application> programs are usually invoked by
+    the <command>gpg-agent</command> daemon, but can be run from the command
+    line as well. There are programs for various text-based and GUI
+    environments, including interfaces designed for
+    <application>Ncurses</application> (text-based),
+    <application>Gtk+</application>, <application>Gtk+-2</application>,
+    and <application>Qt-3</application>.</para>
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Download (HTTP): <ulink url="&pinentry-download-http;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download (FTP): <ulink url="&pinentry-download-ftp;"/></para>
+      </listitem>
+      <listitem>
+        <para>Download MD5 sum: &pinentry-md5sum;</para>
+      </listitem>
+      <listitem>
+        <para>Download size: &pinentry-size;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated disk space required: &pinentry-buildsize;</para>
+      </listitem>
+      <listitem>
+        <para>Estimated build time: &pinentry-time;</para>
+      </listitem>
+    </itemizedlist>
+
+    <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>Required patch: <ulink
+        url="&patch-root;/pinentry-&pinentry-version;-fixes-1.patch"/></para>
+      </listitem>
+    </itemizedlist> -->
+
+    <bridgehead renderas="sect3">PIN-Entry Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional"><xref linkend="GTK"/>,
+    <xref linkend="gtk2"/>,
+    <xref linkend="qt"/>, and
+    <ulink url="http://packages.debian.org/stable/source/libcap">libcap</ulink></para>
+
+    <para condition="html" role="usernotes">User Notes:
+    <ulink url="&blfs-wiki;/pinentry"/></para>
+
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of PIN-Entry</title>
+
+    <para>Install <application>PIN-Entry</application> by running the following
+    commands:</para>
+
+<screen><userinput>./configure --prefix=/usr &&
+make</userinput></screen>
+
+    <para>Only <command>info</command> documentation is shipped in the package
+    tarball. If you wish to build alternate formats of the documentation, you
+    must have <xref linkend="tetex"/> installed, then issue the following
+    commands:</para>
+
+<screen><userinput>make -k -C doc pdf ps html &&
+makeinfo --html --no-split -o doc/pinentry_nochunks.html doc/pinentry.texi &&
+makeinfo --plaintext       -o doc/pinentry.txt           doc/pinentry.texi</userinput></screen>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>make install &&
+install -v -m644 -D README /usr/share/doc/pinentry-&pinentry-version;/README</userinput></screen>
+
+    <para>If you built the additional documentation, install it by issuing the
+    following commands as the <systemitem class="username">root</systemitem>
+    user:</para>
+
+<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/pinentry-&pinentry-version;/html &&
+install -v -m644 doc/pinentry.html/* \
+                    /usr/share/doc/pinentry-&pinentry-version;/html &&
+install -v -m644 doc/pinentry_*.html \
+                    /usr/share/doc/pinentry-&pinentry-version; &&
+install -v -m644 doc/pinentry.{pdf,ps,dvi,txt,texi} \
+                    /usr/share/doc/pinentry-&pinentry-version;</userinput></screen>
+
+  </sect2>
+
+  <!-- <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para><parameter></parameter>: This parameter
+    </para>
+
+  </sect2> -->
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directory</segtitle>
+
+      <seglistitem>
+        <seg>pinentry, pinentry-curses, pinentry-gtk, pinentry-gtk-2,
+        and pinentry-qt</seg>
+        <seg>None</seg>
+        <seg>/usr/share/doc/pinentry-&pinentry-version;</seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <varlistentry id="pinentry-prog">
+        <term><command>pinentry</command></term>
+        <listitem>
+          <para>is a symbolic link to the default
+          <application>PIN-Entry</application> program.</para>
+          <indexterm zone="pinentry pinentry-prog">
+            <primary sortas="g-pinentry">pinentry</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="pinentry-curses">
+        <term><command>pinentry-curses</command></term>
+        <listitem>
+          <para> is an <application>Ncurses</application> text-based
+          <application>PIN-Entry</application> program.</para>
+          <indexterm zone="pinentry pinentry-curses">
+            <primary sortas="g-pinentry-curses">pinentry-curses</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="pinentry-gtk">
+        <term><command>pinentry-gtk</command></term>
+        <listitem>
+          <para> is a <application>Gtk</application> GUI
+          <application>PIN-Entry</application> program.</para>
+          <indexterm zone="pinentry pinentry-gtk">
+            <primary sortas="g-pinentry-gtk">pinentry-gtk</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="pinentry-gtk-2">
+        <term><command>pinentry-gtk-2</command></term>
+        <listitem>
+          <para> is a <application>Gtk-2</application> GUI
+          <application>PIN-Entry</application> program.</para>
+          <indexterm zone="pinentry pinentry-gtk-2">
+            <primary sortas="g-pinentry-gtk-2">pinentry-gtk-2</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="pinentry-qt">
+        <term><command>pinentry-qt</command></term>
+        <listitem>
+          <para> is a <application>Qt</application> GUI
+          <application>PIN-Entry</application> program.</para>
+          <indexterm zone="pinentry pinentry-qt">
+            <primary sortas="g-pinentry-qt">pinentry-qt</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </sect2>
+
+</sect1>


Property changes on: trunk/BOOK/general/genutils/pinentry.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2007-08-18 20:01:45 UTC (rev 7084)
+++ trunk/BOOK/general.ent	2007-08-19 12:39:33 UTC (rev 7085)
@@ -3,7 +3,7 @@
 $Date$
 -->
 
-<!ENTITY day          "17">                   <!-- Always 2 digits -->
+<!ENTITY day          "19">                   <!-- Always 2 digits -->
 <!ENTITY month        "08">                   <!-- Always 2 digits -->
 <!ENTITY year         "2007">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -184,6 +184,7 @@
 <!ENTITY xterm-version                "225">
 <!ENTITY icon-naming-utils-version    "0.8.2">
 <!ENTITY rxvt-unicode-version         "8.2">
+<!ENTITY pinentry-version             "0.7.3">
 
 <!-- Chapter 11 -->
 <!ENTITY gpm-version                  "1.20.1">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2007-08-18 20:01:45 UTC (rev 7084)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2007-08-19 12:39:33 UTC (rev 7085)
@@ -42,6 +42,15 @@
 -->
 
     <listitem>
+      <para>August 19, 2007</para>
+      <itemizedlist>
+        <listitem>
+          <para>[randy] - Added new package PIN-Entry-0.7.3.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>August 18th, 2007</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2007-08-18 20:01:45 UTC (rev 7084)
+++ trunk/BOOK/introduction/welcome/credits.xml	2007-08-19 12:39:33 UTC (rev 7085)
@@ -283,7 +283,7 @@
         MIT Kerberos V5 (many updates and enhancements), MPlayer
         (extensive overhaul), NSS, Orca, Other Programming Tools, PDL,
         Perl Modules,
-        pilot-link, Poppler, Pth, PyXML, Samba 3 (many additions),
+        pilot-link, PIN-Entry, Poppler, Pth, PyXML, Samba 3 (many additions),
         SANE (original instructions by Alex Kloss),
         Shadow (rewrite), SLIB, Sound Juicer,
         Stunnel, Subversion Client (many additions), Sysstat,




More information about the blfs-book mailing list