gschem/docs/gschem.1

   1 .TH gschem 1 "January 15th, 2011" Version 1.6.2.20110115
   2 .SH NAME
   3 gschem - gEDA/gaf Schematic Capture
   4 .SH SYNOPSIS
   5 .B gschem
   6 [\-q] [\-v] [\-t] [\-r rcfilename] [\-s scriptfilename] [\-o outputfilename] [\-p] [\-h] [schematic1 ... schematicN]
   7 .SH DESCRIPTION
   8 .PP
   9 \fIgschem\fP is the schematic capture program which is part gEDA
  10 (GPL Electronic Design Automation) toolset.  This program is used to draw
  11 electronic schematics.  Schematics consist of standard symbols (which
  12 are either part of a standard library or created by the user) which
  13 represent the various gates and components.  These components are then
  14 interconnected by nets (wires).  Schematics may be printed to a
  15 PostScript file for printing or further conversion to other output
  16 formats.  Output to various image formats is also supported.
  17
  18 \fIgschem\fP is also the symbol creation editor.  All the standard
  19 methods of creating schematics are used in the creation of symbols. There
  20 are a few special rules when creating symbols, so please refer to the
  21 (non-existant as of now) symbol creation document.
  22
  23 Please read the official documentation (very minimal at this point)
  24 on how to use \fIgschem\fP, since this man page just describes the command
  25 line arguments and a few examples on how to run \fIgschem\fP.
  26
  27 .SH OPTIONS
  28 \fIgschem\fP accepts the following options:
  29 .TP 8
  30 .B -q
  31 Quiet mode on.  This mode turns off all warnings/notes/messages. (optional)
  32 .TP 8
  33 .B -v
  34 Verbose mode on.  This mode gives as much feedback to the user as possible. (optional)
  35 .TP 8
  36 .B -t
  37 Print out more information when using mouse strokes.  With this command
  38 line flag and the middle button configured for mouse strokes, gschem
  39 will output the stroke sequence numbers as the user executes strokes.
  40 These numbers can be used to define new strokes in the system-gschemrc file.
  41 .TP 8
  42 .B -r filename
  43 Specify a rc filename.  Normally \fIgschem\fP searches for the system-gschemrc, then
  44 ~/.gEDA/gschemrc, and finally for a gschemrc in the current directory.  This
  45 options allows the user to specify an additional rc file which is read after
  46 all the other rc files are read. (optional)
  47 .TP 8
  48 .B -s filename
  49 Specify a guile script to be executed at startup. (optional)
  50 .TP 8
  51 .B -o filename
  52 Specify a filename for postscript output.  This command line argument is
  53 useful when running \fIgschem\fP from a shell script and with a guile script.  The
  54 filename can be changed through
  55 the print dialog box.
  56 .TP 8
  57 .B -p
  58 Automatically place the window, especially useful if running gschem from the
  59 command line and generating output.
  60 .TP 8
  61 .B -h
  62 Print out short command line help.
  63 .TP 8
  64 .B schematic1 [... schematicN]
  65 Schematic file to be loaded.  Specifing a schematic file is optional.  If
  66 multiple schematic files are specified they are read in sequentially and
  67 put on seperate pages.  It is important that the schematic(s) follow
  68 all the options (ie last).
  69
  70 .SH EXAMPLES
  71 These examples assume that you have a schematic called stack_1.sch in
  72 the current directory
  73
  74 To run \fIgschem\fP and then interact with the program:
  75
  76         gschem
  77 .br
  78
  79 To run \fIgschem\fP in interactive mode but load a sample schematic:
  80
  81         gschem adders_1.sch
  82
  83 To run \fIgschem\fP and load up all schematics in the current subdirectory:
  84
  85         gschem *.sch
  86
  87 .SH "ENVIRONMENT"
  88 \fIgschem\fP respects the following environment variable:
  89 .PP
  90 .TP 8
  91 .B GEDADATA
  92 specifies where the various required scheme and rc files are located
  93 (the default is ${prefix}/share/gEDA).  This environment variables does
  94 not need to be set by the end user unless they are moving the executables
  95 to a new install ${prefix}.
  96
  97 .SH "AUTHOR"
  98 Ales Hvezda and many others
  99
 100 .SH SEE ALSO
 101 .BR gnetlist (1),
 102 .BR gsymcheck (1)
 103 .SH COPYRIGHT
 104 .nf
 105 Copyright \(co  1999-2008 Ales Hvezda
 106
 107 This document can be freely redistributed according to the terms of the
 108 GNU General Public License version 2.0
 109