X-Authentication-Warning: delorie.com: mail set sender to geda-user-bounces using -f
X-Recipient: geda-user AT delorie DOT com
MIME-Version: 1.0
X-Originating-IP: [92.236.246.66]
Date: Wed, 14 Dec 2011 07:21:29 +0000
Message-ID: <CANqhZFyzArzykucJ1mLUHz9qVD=919fROUBM8zhFt3vDBGkgHw@mail.gmail.com>
Subject: [geda-user] Proposed tragesym(1) man page - do we need tragesym(5) now as well?
From: Gareth Edwards <gareth AT edwardsfamily DOT org DOT uk>
To: geda-user AT delorie DOT com
Content-Type: multipart/mixed; boundary=0015175dd846704f5c04b408375d
Reply-To: geda-user AT delorie DOT com

--0015175dd846704f5c04b408375d
Content-Type: text/plain; charset=ISO-8859-1

Hi all,

As a small part of addressing Launchpad bug 698849 ("Add manpages for
tools") I've created a minimal manpage for the tragesym script (draft
attached).

However, it doesn't actually tell you that much on how to use the
tool; I'd suggest we really need a tragesym(5) page as well to
describe the file format that it expects on the input.

Question is, does adding the tragesym(1) page for now address the
upstream Debian issue or do we need the file format documented as well
for that ? Of course I think we /should/ have the file format
documented, I just want to know if we consider that it would gate this
particular LP bug so I can prioritise my writing.

Cheers
Gareth

--0015175dd846704f5c04b408375d
Content-Type: application/octet-stream; name="tragesym.1"
Content-Disposition: attachment; filename="tragesym.1"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_gw60f6j40

LlRIIHRyYWdlc3ltIDEgIkp1bmUgMTl0aCwgMjAxMSIgImdFREEgcHJvamVjdCIgMS43LjEuMjAx
MTA2MTkKCi5TSCBOQU1FCnRyYWdlc3ltIFwtIGNyZWF0ZSBnRURBIHN5bWJvbHMgb3V0IG9mIHN0
cnVjdHVyZWQgdGV4dGZpbGVzCgouU0ggU1lOT1BTSVMKLkIgdHJhZ2VzeW0KLkkgc291cmNlZmls
ZSBzeW1ib2xmaWxlCgouU0ggREVTQ1JJUFRJT04KLkIgdHJhZ2VzeW0gCmNyZWF0ZXMgZ3NjaGVt
IHN5bWJvbHMgb3V0IG9mIApzdHJ1Y3R1cmVkIHRleHRmaWxlcy4KLlBQCi5CIHRyYWdlc3ltCmNh
bjoKLklQIFwoYnUKY3JlYXRlIHBpbnMgYW5kIGFycmFuZ2UgdGhlaXIgZWxlbWVudHMgKGNsb2Nr
c2lnbiwgZG90LCB0eXBlLCBwaW5udW1iZXIsIGxhYmVsKTsKLklQIFwoYnUKc29ydCBwaW5zIGFs
cGhhYmV0aWNhbCBhbmQgbnVtZXJpY2FsOwouSVAgXChidQpzd2FwIHdvcmRzIG9mIHBpbmxhYmVs
cyBpZiB3aXNoZWQ7Ci5JUCBcKGJ1CmRyYXcgbmVnYXRpb24gbGluZXMgb24gdGhlIGxhYmVscyAo
c2luY2UgdmVyc2lvbiAwLjAuOSwgZ3NjaGVtIHdpbGwgZG8gdGhhdCk7Ci5JUCBcKGJ1CnJvdGF0
ZSBwaW5sYWJlbHMgaWYgd2lzaGVkOwouSVAgXChidQpkbyBzb21lIHN5bnRheCBjaGVjayB0byB0
aGUgaW5wdXQgZmlsZS4KLlBQCi5CIHRyYWdlc3ltIApyZXF1aXJlcyBweXRob24uCi5TSCBUVVRP
UklBTApUaGVyZSBpcyBhIHR1dG9yaWFsIG9uIHRoZSB1c2Ugb2YKLkIgdHJhZ2VzeW0KYXQ6Ci5J
UApodHRwOi8vZ2VkYS5zZXVsLm9yZy93aWtpL2dlZGE6dHJhZ2VzeW1fdHV0b3JpYWwKLlNIIEFV
VEhPUgpXZXJuZXIgSG9jaCA8d2VybmVyLmhvQGdteC5kZT4KLlNIIFNFRSBBTFNPCi5CUiBnc2No
ZW0gKDEpIHBjYiAoMSkKLlNIIENPUFlSSUdIVAoubmYKQ29weXJpZ2h0IFwoY28gMTk5OS0yMDEx
IGdFREEgQ29udHJpYnV0b3JzLiAgTGljZW5zZSBHUEx2Mis6IEdOVSBHUEwKdmVyc2lvbiAyIG9y
IGxhdGVyLiAgUGxlYXNlIHNlZSB0aGUgYENPUFlJTkcnIGZpbGUgaW5jbHVkZWQgd2l0aCB0aGlz
CnByb2dyYW0gZm9yIGZ1bGwgZGV0YWlscy4KLlBQClRoaXMgaXMgZnJlZSBzb2Z0d2FyZTogeW91
IGFyZSBmcmVlIHRvIGNoYW5nZSBhbmQgcmVkaXN0cmlidXRlIGl0LgpUaGVyZSBpcyBOTyBXQVJS
QU5UWSwgdG8gdGhlIGV4dGVudCBwZXJtaXR0ZWQgYnkgbGF3Lgo=
--0015175dd846704f5c04b408375d--