contrib/olib/olib.1.in

   1 .TH olib 1 "@DATE@" "gEDA Project" @VERSION@
   2
   3 .SH NAME
   4 .B olib
   5 \- OrCAD(tm) library part to gEDA .sym converter
   6
   7 .SH SYNOPSIS
   8 .B olib
   9 .I filename prefix
  10
  11 .SH DESCRIPTION
  12 .B olib
  13 is a simple automated converter from OrCAD v4 (in SDT version 1.10)
  14 ASCII parts library to gEDA component definition in .sym format
  15 file. It allow an initial dumb conversion file to file, with one lib
  16 converted in multiple .sym file, one per component in library.  The
  17 converted component file may need a little editing to become usable,
  18 but in some case needs no editing at all.
  19 .B olib
  20 will write one file per part in the current directory.
  21 .PP
  22 .B olib
  23 will:
  24 .IP \(bu
  25 Convert box-shaped components in OrCAD lib to .sym file in gEDA format;
  26 .IP \(bu
  27 Place pin, pin name, pin type, pin number;
  28 .IP \(bu
  29 Place logic bubble when needed (DOT attribute in OrCAD (TM), for logic
  30 negation);
  31 .IP \(bu
  32 Place clock arrow when needed (CLK attribute);
  33 .IP \(bu
  34 Place reference, from REFERENCE statement in OrCAD;
  35 .IP \(bu
  36 Place part name as label and device name as attribute;
  37 .IP \(bu
  38 Parse and draw non-box component, with LINE, ARC, CIRCLE and TEXT;
  39 .IP \(bu
  40 Add power pin as invisible net=name:pin attribute when detected (in OrCAD,
  41 invisible pin has typically T0 and B0 coords);
  42 .IP \(bu
  43 Through a command line switch, hides pin name in VECTOR drawn symbols,
  44 for a better appearance;
  45 .IP \(bu
  46 Write both new (post-20020825) and old (20020209) file format for .sym files
  47 through a switch on the command line;
  48 .PP
  49 .SH OPTIONS
  50 .TP
  51 filename
  52 The OrCAD library to convert. This should have been
  53 previously converted to ASCII format using the OrCAD 'decomp' utility.
  54 .TP
  55 prefix
  56 The prefix used to generate the filenames of the output gEDA symbols e.g.
  57 prefix-partname-1.sym
  58 .SH LIMITATIONS
  59 .B olib
  60 has the following limitations:
  61 .IP \(bu
  62 .B olib
  63 will not parse and store alternate component drawing (statement CONVERT in
  64 OrCAD);
  65 .IP \(bu
  66 .B olib
  67 will not handle drawing part using VECTOR list from another part (statement
  68 VECTOR 'partname' in OrCAD);
  69 .IP \(bu
  70 .B olib
  71 will not handle FILL statement in VECTOR statement (no equivalent in gEDA);
  72 .IP \(bu
  73 .B olib
  74 will not handle multiple part in one package (slots in gEDA).
  75 .SH AUTHOR
  76 Mario Pascucci <m.pas@libero.it>
  77 .SH SEE ALSO
  78 .BR gschem (1)
  79 .SH COPYRIGHT
  80 .nf
  81 Copyright \(co 1999-@YEAR@ gEDA Contributors.  License GPLv2+: GNU GPL
  82 version 2 or later.  Please see the `COPYING' file included with this
  83 program for full details.
  84 .PP
  85 This is free software: you are free to change and redistribute it.
  86 There is NO WARRANTY, to the extent permitted by law.