Ticket #3762 (closed merge: fixed)

Opened 3 years ago

Last modified 3 years ago

filepath.cabal has an extraneous apostrophe

Reported by: ohnobinki Owned by: igloo
Priority: normal Milestone: 6.12.2
Component: libraries (other) Version:
Keywords: filepath Cc:
Operating System: Unknown/Multiple Architecture: Unknown/Multiple
Type of failure: Documentation bug Difficulty:
Test Case: Blocked By:
Blocking: Related Tickets:

Change History

  Changed 3 years ago by simonmar

  • owner set to simonmar
  • milestone set to 6.12.2

Amazing how many bits have been shoveled around on account of a 1-character punctuation fix. Oh well, thanks for the report anyway!

follow-up: ↓ 3   Changed 3 years ago by igloo

This isn't necessarily a bug; I think FilePath's is generally permitted, especially in technical documentation, to be clear that you are talking about the plural of FilePath rather than something called FilePaths.

(yes, you could have a thing called FilePath's in Haskell, but that's another story...)

in reply to: ↑ 2   Changed 3 years ago by simonmar

  • owner changed from simonmar to igloo
  • type changed from bug to merge

Replying to igloo:

This isn't necessarily a bug; I think FilePath's is generally permitted, especially in technical documentation, to be clear that you are talking about the plural of FilePath rather than something called FilePaths.

Really? I've never come across that. Do you have a reference?

Anyway:

Wed Dec 16 09:58:18 GMT 2009  Simon Marlow <marlowsd@gmail.com>
  * correct punctuation in Synopsis (#3762)

  Changed 3 years ago by igloo

I don't know what a good reference would be for this sort of writing (as "normal" style guides tell you to do things like moving punctuation inside double quotes, which is bad for clarity when dealing with something rigid like programming). The Chicago Manual of Style has a couple of related things:

7.14 (on pluralising noun coinages) "To avoid an awkard appearance, an adjustment in spelling (or sometimes an apostrophe) may be needed", giving "maybe's" as an example.

7.16 "To avoid confusion, lower case letters and abbreviations with two or more interior periods or with both capital and lowercase letters form the plural with an apostrophe and an s", giving "M.A.'s and Ph.D's (or MAs and PhD's)" as examples.

  Changed 3 years ago by igloo

  • status changed from new to closed
  • resolution set to fixed

Fixed in 6.12 by:

Tue Jan 19 13:32:32 GMT 2010  Ian Lynagh <igloo@earth.li>
  * Update to a newer version of filepath; fixes trac #3762
Note: See TracTickets for help on using tickets.