+- Qbasicnews.com (http://qbasicnews.com/newforum)
+-- Forum: Qbasic "like" compilers/interpreters (http://qbasicnews.com/newforum/forum-5.html)
+--- Forum: FB Discussion & Programming Help (http://qbasicnews.com/newforum/forum-15.html)
+---- Forum: FB Documentation (http://qbasicnews.com/newforum/forum-17.html)
+---- Thread: SotSvart: Your OR documentation (/thread-7023.html)
SotSvart: Your OR documentation - Jofers - 04-22-2005
Okay, here we go: It was actually pretty good. You definately have the freedoc format down solid. Just make sure that you leave the revision tag out of the header when you create a document, so it doesn't leave an mm/dd/yyyy there.
The other thing is the amount of detail that it describes. OR is much more than a bitwise operation. It is used in conditions, and is a primitive computation (OR gates are common in hardware design). It also might help to
I redid the document for reference, leaving you as the author and implementing the chart format you asked about. You can modify the document to how you see fit. I did this in two hours: my grammer, information and whole approach to explaining it may be off. But it's just to demonstrate the amount of detail you should consider when documenting a language element.
http://www.betterwebber.com/stuff/kw_or.xml
SotSvart: Your OR documentation - SotSvart - 04-22-2005
Ok, I see what you mean, Ill try to make my docs alot more informative.
Quote:It also might help to..Could you finish this sentence please
How would your chart output? Something like this?
Code:
Bit1: 0 Bit1: 0 Bit1: 1 Bit1: 1
Bit2: 0 Bit2: 1 Bit2: 0 Bit2: 1
Result: 0 Result: 1 Result: 1 Result: 1SotSvart: Your OR documentation - Jofers - 04-22-2005
I'm not really quite sure how to finish that. I'm a forgetful person sometimes
WAIT!! Never mind!!! You SHOULD use <row> in that chart.
Then it would output like this:
That chart would output like this using <row>s:
Code:
A B Result
---- ---- --------
0 0 0
0 1 1
1 0 1
1 1 1If you used <column>, I guess it would output like this:
Code:
A: 0 0 1 1
B: 0 1 0 1
Result: 0 1 1 1SotSvart: Your OR documentation - SotSvart - 04-26-2005
k, have updated my docs + written one for NOT. Havent uploaded anything yet, will do when I get home from work in about 4 hours.
Just one question, how do I move files in the cvs folder? Should i cut n paste the file into the new directory and ADD it, n then COMMIT the changes? Im just afraid cvs will duplicate the file so the latest changed file gets added to the Complete folder, but the old one still stays in the Incomplet folder..
SotSvart: Your OR documentation - Jofers - 04-26-2005
I'm not sure either. I had trouble with that.
SotSvart: Your OR documentation - DrV - 04-29-2005
Do a regular local filesystem copy; commit the copy; do a CVS Remove on the original.