Commit [88a772] Maximize Restore History

Merge branch 'master' of ssh://git.code.sf.net/p/trustedqsl/tqsl

Dave Bernstein Dave Bernstein 2013-03-14

1 2 3 .. 7 > >> (Page 1 of 7)
added apps/.gitignore
removed apps/BUGS
removed apps/LICENSE
removed apps/missing
removed apps/setup.iss.in
removed apps/touchver.pl
removed apps/wpwd.bat
removed src/doxygen/html/adif_8h-source.html
removed src/doxygen/html/cabrillo_8h-source.html
removed src/doxygen/html/doxygen.gif
changed apps/CMakeLists.txt
changed apps/TrustedQSL.spec.in
changed apps/tqsl.cpp
changed src/doxygen/html/annotated.html
changed src/doxygen/html/doxygen.png
changed src/doxygen/html/files.html
changed src/doxygen/html/globals.html
changed src/doxygen/html/globals_func.html
changed src/doxygen/html/globals_type.html
changed src/doxygen/html/globals_vars.html
changed src/doxygen/html/group__ADIF.html
changed src/doxygen/html/group__Cabrillo.html
changed src/doxygen/html/group__CertStuff.html
copied apps/INSTALL -> apps/trustedqsl.5
apps/.gitignore Diff Switch to side-by-side view
Loading...
apps/BUGS
File was removed.
apps/LICENSE
File was removed.
apps/missing
File was removed.
apps/setup.iss.in
File was removed.
apps/touchver.pl
File was removed.
apps/wpwd.bat
File was removed.
src/doxygen/html/doxygen.gif
File was removed.
apps/CMakeLists.txt Diff Switch to side-by-side view
Loading...
apps/TrustedQSL.spec.in Diff Switch to side-by-side view
Loading...
apps/tqsl.cpp Diff Switch to side-by-side view
Loading...
src/doxygen/html/annotated.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/doxygen.png Diff Switch to side-by-side view
Loading...
src/doxygen/html/files.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/globals.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/globals_func.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/globals_type.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/globals_vars.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/group__ADIF.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/group__Cabrillo.html Diff Switch to side-by-side view
Loading...
src/doxygen/html/group__CertStuff.html Diff Switch to side-by-side view
Loading...
apps/INSTALL to apps/trustedqsl.5
--- a/apps/INSTALL
+++ b/apps/trustedqsl.5
@@ -1,157 +1,114 @@
-TrustedQSL
-==========
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH TRUSTEDQSL 5 "March 12, 2013"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+TrustedQSL \- digitally sign amateur radio contact logs
+.SH SYNOPSIS
+.B tqslcert
+.RI [ certificate-file ] "" ...
+.PP
+.B tqsl
+.RI [ OPTIONS ]
+.RI [ log-file ] "" ...
+.SH DESCRIPTION
+.B TrustedQSL
+is a file format and set of procedures that is used to send digitally signed
+QSL information (logs of contacts between amateur radio operators).
+One notable service that makes use of TrustedQSL is ARRL's
+.I Logbook of the World.
+.PP
+The \fBtqslcert\fP program is used to generate requests for digital
+certificates and to store the resulting received digital certificates.
+.PP
+The \fBtqsl\fP program is used to digitally sign contact log files using
+a digital certificate.
+.PP
+This manual page briefly documents the \fBtqslcert\fP and \fBtqsl\fP programs.
+Complete documentation is also available:
+.sp
+  \fBtqslcert\fP: file:///usr/share/TrustedQSL/help/tqslcert/main.htm
+.sp
+  \fBtqsl\fP: file:///usr/share/TrustedQSL/help/tqslapp/main.htm
+.SH OPTIONS
 
-This is the TrustedQSL application suite, part of the TrustedQSL
-project:
+.PP
+\fBtqslcert\fP accepts TQSL certificate files which may
+optionally be specified on the command line.
 
-http://sourceforge.net/projects/trustedqsl/
+.PP
+\fBtqsl\fP accepts these command line options:
 
-===================================================================
-Contents
+.TP
+.B \-d
+Suppress date-range dialog. If present, the QSO date-range dialog will not be
+shown for files that follow this option on the command line.
 
-1) Prerequisites
+.TP
+.B \-l \fIlocation_name\fP
+Selects an existing station location. This location will be used for the
+commands that follow. If the station location doesn't exist, \fBtqsl\fP will
+just exit.
 
-2) Building the Applications under Unix
+.TP
+.B \-o \fIoutput_file\fP
+Writes the resulting signed log file to \fIoutput_file\fP instead of a default
+name based on the input \fIlog-file\fP name.
 
-3) Building the Applications under Mac OS X
+.TP
+.B \-s
+Add or edit station location. If there is a preceding -l option the specified
+location will be edited. If there is no preceding -l option, a new station
+location is being added.
 
-4) Building the Applications under Windows.
+.TP
+.BR \-x " (or) " \-q
+Exit \fBtqsl\fP. If this argument is used it should be the last one on the
+command line. If this argument is not present, \fBtqsl\fP will begin normal
+operation after successfully processing all command-line arguments.
 
-===================================================================
+.TP
+.B \-u
+Upload log file. If this argument is used, the input files will be signed
+then automatically uploaded to the Logbook of the World web site for
+processing.
 
-1) Prerequisites
+.TP
+.B \-v
+Display the version number of \fBtqsl\fP and exit.
 
-These applications require the tqsllib library. First build and
-install that library and its prerequisites.
+.TP
+.B log-files
+Any command-line parameter that is not an option or an option's argument will
+be treated as the name of a log file (ADIF or Cabrillo) to be signed. The
+resulting signed file (.tq8) will be placed in the same directory as the log
+file, overwriting any existing .tq8 file of the same name. (Note: If this
+option is not preceded by a -l option that selects the station location to be
+used for signing, the Select Station Location for Signing dialog will be
+presented.) File names that contain spaces or other shell-special characters
+should be quoted in a manner suitable for the operating system and shell that's
+being used. If -u is used, the signed log is not saved to disk but is instead
+uploaded and submitted to Logbook of the World.
+.sp
+N.B.: If the private key needed to sign a log is protected by a
+password, the user will be prompted to supply that password for each file being
+signed.
 
-In the instructions that follow, the versions of other packages
-that were used to build the TrustedQSL package as of the date this
-document was last updated are given in parentheses.
-
-These applications make use of the wxWindows/wxWidgets GUI
-framework. (http://www.wxwindows.org/) Version 2.4.2 or later
-is required. (2.5.x recommended for Mac OS X.) For Unix and
-Mac OS X, follow the build instructions found there, or install
-the wxWindows/wxWidgets packages appropriate for your platform.
-
-Building under Windows also requires Inno Setup (version 3 or
-later), http://www.jrsoftware.org/isinfo.php.
-
-For Windows, the installable wxWindows package targets VC++.
-It may be possible to build these applications under VC++,
-but these instructions cover building the application under
-the MSYS/MinGW environment used to build the tqsllib library.
-(Note that to run the applications does *not* require any special
-environment.)
-
-===================================================================
-
-2) Building the Applications under Linux/Unix
-
-The quick answer:
-
-./configure
-make
-make install
-
-That will install the Applications under /usr/local/bin and the
-initial configuration data under /usr/local/share/tqsl.
-
-You can change the install location via:
-./configure --prefix=/foo/bar
-
-If you installed the tqsllib library or its dependent libraries
-in locations that configure can't find, you'll need to specify
-those locations to configure. See:
-
-./configure --help
-
-===================================================================
-
-3) Building the Applications under Mac OS X
-
-You'll need to have the Mac developer's tools, Xcode 1.5, installed.
-
-This is done in much the same manner as building under Linux/Unix, above.
-However, you ought *not* do "make install." Using Terminal, simply do:
-
-./configure
-make
-
-For a universal (PowerPC plus Intel) binary compatible with MacOS 10.4 or later:
-
-./configure \
-    --with-tqsllib=/usr/local  --with-tqslinc=/usr/local \
-    --with-expat=/usr/local  --with-wxwindows=/usr/local \
-    CC=gcc-4.0 LD=gcc-4.0 CXX=c++-4.0 \
-    CFLAGS="\
-	-I /usr/include/c++/4.0.0 \
-	-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
-	-arch ppc -arch i386 \
-	-mmacosx-version-min=10.4 \
-	-fno-stack-protector"  \
-    CXXFLAGS="\
-	-isysroot /Developer/SDKs/MacOSX10.4u.sdk \
-	-arch ppc -arch i386 \
-	-mmacosx-version-min=10.4 \
-	-fno-stack-protector"  \
-    LDFLAGS="\
-	-Wl,-syslibroot,/Developer/SDKs/MacOSX10.4u.sdk \
-	-mmacosx-version-min=10.4 \
-	-arch ppc -arch i386 " \
-make
-
-This will result in the directories dist/TrustedQSL/tqsl.app and
-tqslcert.app, which comprise complete Mac OS X applications. You
-can simply move the dist/TrustedQSL folder to your system's
-Applications folder or the location of your choice, then launch
-the applications from Finder. If you want to distribute the built
-applications:
-
-make dmg
-
-will make TrustedQSL-1.12.dmg, a Mac distributable disk image
-containing the TrustedQSL applications folder and document files.
-
-===================================================================
-
-4) Building the Applications under Windows
-
-Before you can build the applications under Windows you must
-first build the tqsllib DLL. In doing so, you will set up the
-MSYS/MinGW environment as needed.
-
-STEP 1) Install needed other packages
-
-Install wxWindows/WxWidgets [wxMSW] (2.4.2)
-
-(The wxMSW installation suggests that you set an environment
-variable, WXWIN, to the base directory of your installation.
-The following directions assume you did that.)
-
-Install Inno Setup (5.0.7)
-
-STEP 2) Build the wxWindows/wxWidgets library
-
-cd $WXWIN
-mkdir build
-cd build
-../configure --disable-threads --with-msw --disable-shared --prefix=$HOME/wx
-make install
-
-STEP 3) Build the TrustedQSL applications
-
-Note: If you installed Inno Setup in a location other that its
-default, configure may need the --with-inno switch. For assistance,
-see:
-
-./configure --help
-
-cd
-tar -xzf TrustedQSL-1.12.tar.gz
-cd TrustedQSL-1.12
-./configure --without-openssl
-make installer
-
-This should result in a file, tqsl-112.exe. This is an executable
-setup file that will install the TrustedQSL applications.
+.SH AUTHOR
+trustedqsl was written by "American Radio Relay League, Inc." and the TrustedQSL authors. Please see the AUTHORS.txt file in the source distribution for a list of contributors.
+.PP
+This manual page was prepared by Kamal Mostafa <kamal@whence.com>,
+for the Debian project (and may be used by others).
1 2 3 .. 7 > >> (Page 1 of 7)