[Bikeshed] writ or write?
Daniel Friesen
definition for that term, I just think I understand the meaning from all
the uses on the list)
writ or write? writable or writeable?
Most api's appear to use writable rather than writeable.
One of my spell checkers says writable is correct and writeable is
incorrect, another says writeable is correct and writable is incorrect.
A check in my word reference lists writable with a note on 'Also
"writeable"', so it looks like both are correct in different places.
Arguments:
* writ is the same length as read, using writ means that writable and
readable fit parallel on the same line.
* As "write" is the full word, writeable is the most easily expected form.
* writable is what most other api stick to.
* writeable is consistent with canWrite
(just a writ vs. write preference, not necessarily the names we'll be
using always)
A) writable and canWrit
B) writable and canWrite
C) writeable and canWrite
--
~Daniel Friesen (Dantman, Nadir-Seen-Fire) [http://daniel.friesen.name]
Tom Robinson
from an earlier thread, fwiw:
On Aug 31, 2009, at 11:26 AM, Mike Wilson wrote:
> A small anecdote is in place :-)
> Many years ago I read an interview with Kernighan and
> Ritchie, and towards the end the interviewer asked
> what they would change in Unix if they could do it
> all over again. The reply was "not to abbreviate the
> "create" function into creat()".
Daniel Friesen
real word, not a arbitrary abbreviation (why I noted 3 options).
Kris Kowal
>
> Ok, short bikeshed. (ok, confession, I haven't bothered to read the
> definition for that term, I just think I understand the meaning from all
> the uses on the list)
>
> writ or write? writable or writeable?
2,670,000 results for writable
861,000 results for writeable
The Google has spoken.
Kris Kowal
Mário Valente
Anyway:
- I'm for write, not writ
- I dont like either writable or writeable; too many chars; I'd prefer canWrite (consistent
with write() or, in keeping up with previous discussion, use whatever Java is using
-- MV
Ash Berlin
>> (just a writ vs. write preference, not necessarily the names we'll be
>> using always)
>> A) writable and canWrit
>> B) writable and canWrite
>> C) writeable and canWrite
>>
>>
>
> Hmmm arent these the wrong options? Wasnt this about writ/write and
> writable/writeable ?
>
> Anyway:
>
> - I'm for write, not writ
> - I dont like either writable or writeable; too many chars; I'd prefer
> canWrite (consistent
> with write() or, in keeping up with previous discussion, use whatever
> Java
> is using
>
We are all agreed. 'writ' is horrible.
However the pedant in me would like to point out that a writable stream is
different to one which you canWrite to at the moment. but a writeable
stream should be duck-typed by the presence of a write method I think.
Wes Garland
canWrite and writeable imply completely different things.
canWrite: CAN I write -- i.e. is there room on the disk? Is the stream output buffer full?
writeable: MAY I write -- is this stream open for writing
As for "writable", that's a word that indicates whether or not you can serve a writ (~legal document).
Wes
--
Wesley W. Garland
Director, Product Development
PageMail, Inc.
+1 613 542 2787 x 102
Daniel Friesen
1. capable of being written or set down in writing.
2. /Computers/. capable of recording data: /writable/ DVDs
Also, write‧a‧ble.
I believe we use isWritable/isWriteable, isReadable, ... in fs to check
if we have permissions to read/write a file.
I included writable/writeable and canWrit/canWrite for the reason you
note. I only wanted opinions on writ vs. write, what form "canWrite,
writable, writeBlocked, canIcallWriteWithoutItThrowingAnError, etc..."
is used will depend on the api it's being used in and it's purpose.
fwiw, rather than canWrite I'm using readBlocked/writeBlocked inside the
IO/B/Stream I'm drafting as what I'm trying to indicate is "can
read()/write() be called without it holding up waiting for something in
it's way". One distinction there is you can't really read if there is
nothing left in the stream, but .read() won't block, it'll just return
EOF, thus you can't /read/ but read isn't blocked.
Wes Garland
Wow! I can't believe you caught me in an English syntax glitch. ;)
You're right, of course. I need to stop posting before my morning coffee.
And to be clear, "writ" is an abomination IMHO.