1refdes_renum(1)                 1.8.2.20130925                 refdes_renum(1)
2
3
4

NAME

6       refdes_renum - gEDA/gaf refdes renumbering utility
7

SYNOPSIS

9       refdes_renum [--nocopy] [--pgskip [ number ] ] file1 ...
10
11       refdes_renum --help
12
13       refdes_renum --version
14

DESCRIPTION

16       refdes_renum  reads  a gschem schematic file or files and renumbers all
17       reference designators.  The reference designators are numbered starting
18       with 1 and the old schematic file is replaced by the modified schematic
19       file.
20

OPTIONS

22       --help Display a help message.
23
24       --nocopy
25              If given, this flag leaves the modified files in new files whose
26              names are generated by appending a `.renum' to the original file
27              names.  The default is to overwrite the original.
28
29       --pgskip
30              When this flag is used, components on the first schematic  sheet
31              are numbered starting with 101.  On the second sheet, they start
32              with 201, etc  Specifying a value gives the step between  pages.
33              For example --pgskip 10 will start with 11, 21, 31, etc.
34
35       --gentle
36              This flag tells refdes_renum to leave any refdeses alone if they
37              already have numbers.  Use this option to number new  components
38              in  a  schematic  which  has  already  been numbered.  Note that
39              --gentle is set by default!
40
41       --force
42              Set this flag to renumber all refdeses, whether they are already
43              numbered or not.
44
45       --verbose
46              Enables verbose output.
47
48       --version
49              Shows the version of this program.
50

RETURN CODES

52       refdes_renum returns the following codes to the shell upon completion:
53
54       0      Program ran successfully.
55
56       1      Error opening or reading input file.
57
58       2      Error opening or writing output file.
59
60       3      Too many components for --pgskip setting.
61
62       4      Internal error (program bug encountered).
63

EXAMPLES

65       To  renumber  the  reference  designators  in  a  single page schematic
66       mysch.sch:
67
68              refdes_renum mysch.sch
69
70       To renumber the  reference  designators  in  schematic  pages  pg1.sch,
71       pg2.sch  and  pg3.sch, with the reference designators on pg1.sch begin‐
72       ning at 101, the designators on pg2.sch beginning at 201, and the  des‐
73       ignators on pg3.sch beginning at 301:
74
75              refdes_renum --pgskip pg1.sch pg2.sch pg3.sch
76

AUTHOR

78       Dan McMahill <danmcmahill@netbsd.org>
79

SEE ALSO

81       grenum(1)
82

84       Copyright © 1999-2011 gEDA Contributors.  License GPLv2+: GNU GPL
85       version 2 or later.  Please see the `COPYING' file included with this
86       program for full details.
87
88       This is free software: you are free to change and redistribute it.
89       There is NO WARRANTY, to the extent permitted by law.
90
91
92
93gEDA Project                 September 25th, 2013              refdes_renum(1)
Impressum