Thread: iostream article review

  1. #16
    [](){}(); manasij7479's Avatar
    Join Date
    Feb 2011
    Location
    *nullptr
    Posts
    2,657
    Quote Originally Posted by grumpy View Post
    Note that my comments are without context of the article: I don't have access (no google account) so can't comment further.
    You should have read only access without an account.

  2. #17
    Registered User
    Join Date
    Jun 2005
    Posts
    6,815
    Quote Originally Posted by manasij7479 View Post
    You should have read only access without an account.
    Regardless of what you think I should have, the link in the OP resolves to a screen that requires sign-in to google using my email address and password.
    Right 98% of the time, and don't care about the other 3%.

    If I seem grumpy or unhelpful in reply to you, or tell you you need to demonstrate more effort before you can expect help, it is likely you deserve it. Suck it up, Buttercup, and read this, this, and this before posting again.

  3. #18
    C++まいる!Cをこわせ!
    Join Date
    Oct 2007
    Location
    Inside my computer
    Posts
    24,654
    Is there a reason why you don't just host this at cpwiki? It's better suited than a google document. Worldwide read access, member write access, no more wrapping lines, rich wiki style features, etc.
    Quote Originally Posted by Adak View Post
    io.h certainly IS included in some modern compilers. It is no longer part of the standard for C, but it is nevertheless, included in the very latest Pelles C versions.
    Quote Originally Posted by Salem View Post
    You mean it's included as a crutch to help ancient programmers limp along without them having to relearn too much.

    Outside of your DOS world, your header file is meaningless.

  4. #19
    Lurking whiteflags's Avatar
    Join Date
    Apr 2006
    Location
    United States
    Posts
    9,613
    You need an account at cpwiki too.

  5. #20
    C++まいる!Cをこわせ!
    Join Date
    Oct 2007
    Location
    Inside my computer
    Posts
    24,654
    Yeah, that was aimed at the writers. The reading you get for free.
    Quote Originally Posted by Adak View Post
    io.h certainly IS included in some modern compilers. It is no longer part of the standard for C, but it is nevertheless, included in the very latest Pelles C versions.
    Quote Originally Posted by Salem View Post
    You mean it's included as a crutch to help ancient programmers limp along without them having to relearn too much.

    Outside of your DOS world, your header file is meaningless.

  6. #21
    spurious conceit MK27's Avatar
    Join Date
    Jul 2008
    Location
    segmentation fault
    Posts
    8,300
    Quote Originally Posted by Elysia View Post
    Meh. I'm not a linguistic expert, so I don't know if what I am typing here is 100% correct.
    An active voice indicates the subject performs the verb -- it is not just a matter of using pronouns like "we" or "you". So that sentence has an active voice ("An active voice" is the subject, "indicates" is the verb). A passive version might be: With an active voice, the verb is performed by the subject. Now "the verb" is the subject, and "is performed" is the verb. See the difference?

    So in a passively voiced statement, the subject is acted upon. Grumpy is correct about the sentences in post 14; the subject is either "the streams we are talking about here" or "the streams being discussed here", and the verb is "are designed". The streams did not design, they were designed, therefore the voice is passive. An active way to say that might be: "The streams being discussed fit almost any data-handling purpose." Notice the somewhat superfluous phrase involving "designed" is no longer necessary. This is a good example of what I said earlier -- that passive voicing encourages long windedness.

    Quote Originally Posted by Elysia View Post
    All in all, learning how to write in passive style is a good skill™.
    How about: writing well is a good skill to learn, and it includes an understanding of the difference between passive and active voicing.
    Last edited by MK27; 09-27-2011 at 03:16 PM.
    C programming resources:
    GNU C Function and Macro Index -- glibc reference manual
    The C Book -- nice online learner guide
    Current ISO draft standard
    CCAN -- new CPAN like open source library repository
    3 (different) GNU debugger tutorials: #1 -- #2 -- #3
    cpwiki -- our wiki on sourceforge

  7. #22
    C++まいる!Cをこわせ!
    Join Date
    Oct 2007
    Location
    Inside my computer
    Posts
    24,654
    Quote Originally Posted by MK27 View Post
    An active voice indicates the subject performs the verb -- it is not just a matter of using pronouns like "we" or "you". So that sentence has an active voice ("An active voice" is the subject, "indicates" is the verb). A passive version might be: With an active voice, the verb is performed by the subject. Now "the verb" is the subject, and "is performed" is the verb. See the difference?
    No, I don't. Like I said, I'm not an expert in the field. I've never really cared about the structure of grammar. It just comes naturally.

    Quote Originally Posted by MK27 View Post
    How about: writing well is a good skill to learn, and it includes an understanding of the difference between passive and active voicing.
    Another good skill, one among many.
    Quote Originally Posted by Adak View Post
    io.h certainly IS included in some modern compilers. It is no longer part of the standard for C, but it is nevertheless, included in the very latest Pelles C versions.
    Quote Originally Posted by Salem View Post
    You mean it's included as a crutch to help ancient programmers limp along without them having to relearn too much.

    Outside of your DOS world, your header file is meaningless.

  8. #23
    [](){}(); manasij7479's Avatar
    Join Date
    Feb 2011
    Location
    *nullptr
    Posts
    2,657
    Quote Originally Posted by grumpy View Post
    Regardless of what you think I should have, the link in the OP resolves to a screen that requires sign-in to google using my email address and password.
    Here is a screenshot from my comp, when opened without signing in. (Look at the Top right) ...Something fishy about Google Account probably !
    iostream article review-screenshot-jpg

  9. #24
    [](){}(); manasij7479's Avatar
    Join Date
    Feb 2011
    Location
    *nullptr
    Posts
    2,657
    Quote Originally Posted by Elysia View Post
    Is there a reason why you don't just host this at cpwiki? It's better suited than a google document. Worldwide read access, member write access, no more wrapping lines, rich wiki style features, etc.
    Sorry, I completely forgot about it while writing this.
    I'd definitely post any other article in future there.

  10. #25
    Lurking whiteflags's Avatar
    Join Date
    Apr 2006
    Location
    United States
    Posts
    9,613
    Quote Originally Posted by Elysia View Post
    Yeah, that was aimed at the writers. The reading you get for free.
    I assumed writers would include people who wanted to comment on the article itself.

  11. #26
    Administrator webmaster's Avatar
    Join Date
    Aug 2001
    Posts
    1,012
    In my opinion, Google Docs is more productive than a wiki for this kind of thing. The rich formatting is not relevant since the article will be posted to the main site, which means that I'll be doing the final HTML formatting anyway. Google docs provides the same worldwide read, and it allows anyone to add comments without an account; for write access, it's a wash. I also like Google Docs comments inline in the text.

  12. #27
    'Allo, 'Allo, Allo
    Join Date
    Apr 2008
    Posts
    639
    Quote Originally Posted by manasij7479 View Post
    Here is a screenshot from my comp
    There are two spaces between Bjarne and Stroustrup.

    There's also a mountain of parentheticals in there, about 10% of the article! The rule I use is 'if you can't work it into the main text, question its usefulness.'
    Given the title, I assume this is meant to be an introductory piece not a treatise, so stuff like:
    Both seek methods take an argument (of type streampos)
    can be omitted, especially as steampos is never mentioned again. IMO, of course.

  13. #28
    [](){}(); manasij7479's Avatar
    Join Date
    Feb 2011
    Location
    *nullptr
    Posts
    2,657
    Quote Originally Posted by adeyblue View Post
    There's also a mountain of parentheticals in there, about 10% of the article! The rule I use is 'if you can't work it into the main text, question its usefulness.'
    Good Idea, I'd remove some of the brackets.
    And if some of the info seems redundant, I'd get rid of it.
    ...can be omitted, especially as steampos is never mentioned again. IMO, of course.
    It is never mentioned again in this introduction, but if I/we/gaia (or someone else) writes specific articles on the details, these small pieces of info can serve as links.

  14. #29
    Lurking whiteflags's Avatar
    Join Date
    Apr 2006
    Location
    United States
    Posts
    9,613
    If we're worried about punctuation: Notes on Punctuation, by Lewis Thomas

    There are no precise rules about punctuation (Fowler lays out some general advice (as best he can under the complex circumstances of English prose (he points out, for example, that we possess only four stops (the comma, the semicolon, the colon and the period (the question mark and exclamation point are not, strictly speaking, stops; they are indicators of tone (oddly enough, the Greeks employed the semicolon for their question mark (it produces a strange sensation to read a Greek sentence which is a straightforward question: Why weepest thou; (instead of Why weepest thou? (and, of course, there are parentheses (which are surely a kind of punctuation making this whole matter much more complicated by having to count up the left-handed parentheses in order to be sure of closing with the right number (but if the parentheses were left out, with nothing to work with but the stops we would have considerably more flexibility in the deploying of layers of meaning than if we tried to separate all the clauses by physical barriers (and in the latter case, while we might have more precision and exactitude for our meaning, we would lose the essential flavor of language, which is its wonderful ambiguity )))))))))))).
    I thought this would help.

  15. #30
    Registered User
    Join Date
    Jun 2005
    Posts
    6,815
    Quote Originally Posted by Elysia View Post
    No, I don't. Like I said, I'm not an expert in the field. I've never really cared about the structure of grammar. It just comes naturally.
    Bad grammar certainly comes naturally to many

    Uninformed criticism is often worse than useless, it is misleading. You offered uninformed, and wrong, criticism of grammatical structure.
    Right 98% of the time, and don't care about the other 3%.

    If I seem grumpy or unhelpful in reply to you, or tell you you need to demonstrate more effort before you can expect help, it is likely you deserve it. Suck it up, Buttercup, and read this, this, and this before posting again.

Popular pages Recent additions subscribe to a feed

Similar Threads

  1. Article in GDM about DarkBasic PRO
    By jasonkidd05 in forum Game Programming
    Replies: 5
    Last Post: 02-03-2008, 04:47 AM
  2. Article
    By crvenkapa in forum A Brief History of Cprogramming.com
    Replies: 1
    Last Post: 05-15-2007, 01:23 AM
  3. critique this article
    By kermit in forum A Brief History of Cprogramming.com
    Replies: 10
    Last Post: 10-13-2004, 08:28 PM
  4. Article in GDM about DarkBasic PRO
    By DavidP in forum A Brief History of Cprogramming.com
    Replies: 2
    Last Post: 09-03-2003, 06:27 PM