Re: Bug#818229: caneda: Typo in the package description
Package: caneda
Followup-For: Bug #818229
Tags: patch
Thomas Vincent <thomas@vinc-net.fr> wrote:
> I found a typo while translating Caneda's package description.
> Indeed, it states that its goal is the "complete design proccess […]".
> Process is mispelled in this sentence and should be corrected.
I'm not a caneda user or developer, but I happened to notice this
bugreport. The problem you noticed in the package description is not
the only one that needs fixing, so here's a proposed patch.
| Description: Electronic Design Automation software focused on easy of use and portability
There's another misspelling here: it's "ease of use" (nouns,
pronounced "eaze of uce"). And this is much too long, in ways that
are very simple to fix - just use the abbreviation "EDA" here and then
expand it in the long description.
| Caneda is an open source Electronic Design Automation (EDA) software focused
| on easy of use and portability.
This pointlessly repeats the synopsis, with the addition of one new
classic non-native-English-speakerism: "a software". Software is a
non-count noun - I recommend calling it "an application" instead.
| Caneda's goal is the complete design proccess from schematic capture, through
| simulation and into circuit layout and PCB.
s/cc/c/. Also, what does it mean to claim that its goal is the design
process? Does it mean that its goal is to *handle* the complete
process? (The phrasing of "from... through... into" doesn't seem
completely natural English, but I'm trying to keep my tweaks to a
minimum since I don't really understand this field.)
| .
There's no particular reason to put a paragraph break here... let's
keep to the format of one paragraph of boilerplate plus one optional
paragraph of package-specific details.
| The software aims to support all kinds of circuit simulation types, e.g. DC,
| AC, S-parameter and harmonic balance analysis.
Drop the count-nounish use of "the software" - just say "it".
While I'm editing the control file I'll change the long descriptions
for caneda-common and -doc to match. Also, make the synopsis lines
more consistent:
| Description: architecture independent files for caneda
[...]
| Description: documentation for Caneda
Write it as "Caneda" in both.
(It doesn't mention that the name stands for "Circuits And Networks
Electronic Design Automation", but that's okay, it's one for me to add
to "http://wiki.debian.org/WhyTheName";!)
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ru caneda-0.1.0.pristine/debian/control caneda-0.1.0/debian/control
--- caneda-0.1.0.pristine/debian/control 2016-03-08 13:11:58.000000000 +0000
+++ caneda-0.1.0/debian/control 2016-03-14 22:09:08.967616193 +0000
@@ -18,25 +18,22 @@
Architecture: any
Depends: caneda-common, ${misc:Depends}, ${shlibs:Depends}
Suggests: caneda-doc, ngspice
-Description: Electronic Design Automation software focused on easy of use and portability
- Caneda is an open source Electronic Design Automation (EDA) software focused
- on easy of use and portability.
- Caneda's goal is the complete design proccess from schematic capture, through
- simulation and into circuit layout and PCB.
- .
- The software aims to support all kinds of circuit simulation types, e.g. DC,
- AC, S-parameter and harmonic balance analysis.
+Description: EDA software focused on ease of use and portability
+ Caneda is an open source Electronic Design Automation application
+ with the goal of handling the complete design proccess from schematic
+ capture, through simulation and into circuit layout and PCB. It aims
+ to support all kinds of circuit simulation types, e.g. DC, AC,
+ S-parameter and harmonic balance analysis.
Package: caneda-common
Architecture: all
Depends: ${misc:Depends}
-Description: architecture independent files for caneda
- Caneda is an open source EDA software focused on easy of use and portability.
- Caneda's goal is the complete design proccess from schematic capture, through
- simulation and into circuit layout and PCB.
- .
- The software aims to support all kinds of circuit simulation types, e.g. DC,
- AC, S-parameter and harmonic balance analysis.
+Description: architecture independent files for Caneda
+ Caneda is an open source Electronic Design Automation application
+ with the goal of handling the complete design proccess from schematic
+ capture, through simulation and into circuit layout and PCB. It aims
+ to support all kinds of circuit simulation types, e.g. DC, AC,
+ S-parameter and harmonic balance analysis.
.
This package provides the arch-independent common files for caneda.
@@ -45,11 +42,10 @@
Section: doc
Depends: ${misc:Depends}
Description: documentation for Caneda
- Caneda is an open source EDA software focused on easy of use and portability.
- Caneda's goal is the complete design proccess from schematic capture, through
- simulation and into circuit layout and PCB.
- .
- The software aims to support all kinds of circuit simulation types, e.g. DC,
- AC, S-parameter and harmonic balance analysis.
+ Caneda is an open source Electronic Design Automation application
+ with the goal of handling the complete design proccess from schematic
+ capture, through simulation and into circuit layout and PCB. It aims
+ to support all kinds of circuit simulation types, e.g. DC, AC,
+ S-parameter and harmonic balance analysis.
.
This package provides the documentation for Caneda.
Reply to: