[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
gEDA-cvs: gaf.git: branch: master updated (1.7.1-20110619-257-gce4662c)
The branch, master has been updated
via ce4662cfda106f037b02e165a97d73121f0ea195 (commit)
via 6dc5ca24dd5a079dfe40ba5244017de9199e9f3b (commit)
from 361ed60e515c4bb4796b576004906955ef242a33 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
=========
Summary
=========
NEWS | 3 +
utils/docs/Makefile.am | 4 +-
utils/docs/refdes_renum.1 | 91 ++++++++++++++++++++++++++++++++++++++++++++
utils/scripts/refdes_renum | 13 +++++-
4 files changed, 107 insertions(+), 4 deletions(-)
create mode 100644 utils/docs/refdes_renum.1
=================
Commit Messages
=================
commit ce4662cfda106f037b02e165a97d73121f0ea195
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Peter TB Brett <peter@xxxxxxxxxxxxx>
Add man page for refdes_renum and explain examples.
Convert the usage message from the Perl source for refdes_renum into a
man page for said script. Also add a brief description of what the examples
do to the refdes_renum script usage() message.
Affects-bug: lp-698849
:100644 100644 8ac77fd... 53c23be... M utils/docs/Makefile.am
:000000 100644 0000000... f81c6a5... A utils/docs/refdes_renum.1
:100755 100755 88e1876... 65163fa... M utils/scripts/refdes_renum
commit 6dc5ca24dd5a079dfe40ba5244017de9199e9f3b
Author: Peter TB Brett <peter@xxxxxxxxxxxxx>
Commit: Peter TB Brett <peter@xxxxxxxxxxxxx>
Update NEWS.
:100644 100644 fdd42b0... b035147... M NEWS
=========
Changes
=========
commit ce4662cfda106f037b02e165a97d73121f0ea195
Author: Gareth Edwards <gareth@xxxxxxxxxxxxxxxxxxxx>
Commit: Peter TB Brett <peter@xxxxxxxxxxxxx>
Add man page for refdes_renum and explain examples.
Convert the usage message from the Perl source for refdes_renum into a
man page for said script. Also add a brief description of what the examples
do to the refdes_renum script usage() message.
Affects-bug: lp-698849
diff --git a/utils/docs/Makefile.am b/utils/docs/Makefile.am
index 8ac77fd..53c23be 100644
--- a/utils/docs/Makefile.am
+++ b/utils/docs/Makefile.am
@@ -15,11 +15,11 @@ else
@echo 'The documentation cannot be built from the sources.'
endif
-dist_man_MANS = gsch2pcb.1 grenum.1 gxyrs.1
+dist_man_MANS = gsch2pcb.1 grenum.1 gxyrs.1 refdes_renum.1
# Rules for converting man->html
-html_man_files = gsch2pcb.html grenum.html gxyrs.html
+html_man_files = gsch2pcb.html grenum.html gxyrs.html refdes_renum.html
SUFFIXES = .1 .html
docsmandir=$(docdir)/man
diff --git a/utils/docs/refdes_renum.1 b/utils/docs/refdes_renum.1
new file mode 100644
index 0000000..f81c6a5
--- /dev/null
+++ b/utils/docs/refdes_renum.1
@@ -0,0 +1,91 @@
+.TH refdes_renum 1 "June 19th, 2011" "gEDA project" 1.7.1.20110619
+
+.SH NAME
+refdes_renum \- gEDA/gaf refdes renumbering utility
+.SH SYNOPSIS
+.B refdes_renum [\-\-nocopy] [\-\-pgskip [
+.I number
+.B ] ]
+.I file1
+.B ...
+.PP
+.B refdes_renum --help
+.PP
+.B refdes_renum --version
+.SH DESCRIPTION
+.B refdes_renum
+reads a gschem schematic file or files and renumbers all reference
+designators. The reference designators are numbered starting with 1 and the
+old schematic file is replaced by the modified schematic file.
+.SH OPTIONS
+.TP
+\-\-help
+Display a help message.
+.TP
+\-\-nocopy
+If given, this flag leaves the modified files in new files
+whose names are generated by appending a `.renum' to the
+original file names. The default is to overwrite the original.
+.TP
+\-\-pgskip
+When this flag is used, components on the first schematic sheet
+are numbered starting with 101. On the second sheet, they start
+with 201, etc Specifying a value gives the step between pages.
+For example --pgskip 10 will start with 11, 21, 31, etc.
+.TP
+\-\-gentle
+This flag tells refdes_renum to leave any refdeses
+alone if they already have numbers. Use this option to number
+new components in a schematic which has already been numbered.
+Note that --gentle is set by default!
+.TP
+\-\-force
+Set this flag to renumber all refdeses, whether they are already
+numbered or not.
+.TP
+\-\-verbose
+Enables verbose output.
+.TP
+\-\-version
+Shows the version of this program.
+.SH RETURN CODES
+.B refdes_renum
+returns the following codes to the shell upon completion:
+.TP
+0
+Program ran successfully.
+.TP
+1
+Error opening or reading input file.
+.TP
+2
+Error opening or writing output file.
+.TP
+3
+Too many components for \-\-pgskip setting.
+.TP
+4
+Internal error (program bug encountered).
+.SH EXAMPLES
+To renumber the reference designators in a single page schematic mysch.sch:
+.IP
+refdes_renum mysch.sch
+.PP
+To renumber the reference designators in schematic pages pg1.sch, pg2.sch and
+pg3.sch, with the reference designators on pg1.sch beginning at 101, the
+designators on pg2.sch beginning at 201, and the designators on pg3.sch
+beginning at 301:
+.IP
+refdes_renum \-\-pgskip pg1.sch pg2.sch pg3.sch
+.SH AUTHOR
+Dan McMahill <danmcmahill@xxxxxxxxxx>
+.SH SEE ALSO
+.BR grenum (1)
+.SH COPYRIGHT
+.nf
+Copyright \(co 1999-2011 gEDA Contributors. License GPLv2+: GNU GPL
+version 2 or later. Please see the `COPYING' file included with this
+program for full details.
+.PP
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
diff --git a/utils/scripts/refdes_renum b/utils/scripts/refdes_renum
index 88e1876..65163fa 100755
--- a/utils/scripts/refdes_renum
+++ b/utils/scripts/refdes_renum
@@ -353,8 +353,17 @@ sub usage {
print " 4 Internal error (program bug encountered).\n";
print "\n";
print "Usage examples:\n\n";
- print "\t$pname mysch.sch\n";
- print "\t$pname --pgskip pg1.sch pg2.sch pg3.sch\n";
+ print "\tTo renumber the reference designators in a single page schematic\n";
+ print "\tmysch.sch:\n";
+ print "\n";
+ print "\t\t$pname mysch.sch\n";
+ print "\n\n";
+ print "\tTo renumber the reference designators in schematic pages pg1.sch,\n";
+ print "\tpg2.sch and pg3.sch, with the reference designators on pg1.sch\n";
+ print "\tbeginning at 101, the designators on pg2.sch beginning at 201,\n";
+ print "\tand the designators on pg3.sch beginning at 301:\n";
+ print "\n";
+ print "\t\t$pname --pgskip pg1.sch pg2.sch pg3.sch\n";
print "\n\n";
print "$pname was written by Dan McMahill <dmcmahill\@netbsd.org>\n";
print "\n\n";
commit 6dc5ca24dd5a079dfe40ba5244017de9199e9f3b
Author: Peter TB Brett <peter@xxxxxxxxxxxxx>
Commit: Peter TB Brett <peter@xxxxxxxxxxxxx>
Update NEWS.
diff --git a/NEWS b/NEWS
index fdd42b0..b035147 100644
--- a/NEWS
+++ b/NEWS
@@ -45,6 +45,9 @@ Notable changes in gEDA/gaf 1.7.2
* `gsch2pcb' no longer supports the `m4_command' parameter in project
files.
+* The `--m4-pcbdir' and `--m4-file' arguments to `gsch2pcb' now work
+ again.
+
Notable changes in gEDA/gaf 1.7.1
=================================
_______________________________________________
geda-cvs mailing list
geda-cvs@xxxxxxxxxxxxxx
http://www.seul.org/cgi-bin/mailman/listinfo/geda-cvs