 Notice. New forum software under development. It's going to miss a few functions and look a bit ugly for a while, but I'm working on it full time now as the old forum was too unstable. Couple days, all good. If you notice any issues, please contact me. |
Forum Index : Microcontroller and PC projects : Olimex DuinoMite Mega User Manual Status?
  Page 2 of 2 |
|||||
| Author | Message | ||||
djuqa Guru  Joined: 23/11/2011 Location: AustraliaPosts: 447 |
I am familiar with Adobe READER (The program that allows the reading of ADOBE PDF's) (never use it much But yes I am familiar with it.) (FYI I have used, owned, supported, sold, designed personal computers continually since 1978) I mean a table of contents that is part of the document pages so when it is used on other platforms (i.e. AMAZON Kindle. a really great way to use the user manual). VK4MU MicroController Units |
||||
| JohnS Guru Joined: 18/11/2011 Location: United KingdomPosts: 3800 |
I already see the equivalent of a TOC (with some shortcomings I've posted about). It sounds like user trouble (sorry!). If the Kindle doesn't display it, time to debug the Kindle LOL John |
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
Sorry I mentioned it LOL! I forgot I was deaing with people who use Open-Office  and PDF output for everything (even program code),  when the rest of the world also use OTHER forms of communication and encoding. 
VK4MU MicroController Units |
||||
bigmik Guru Joined: 20/06/2011 Location: AustraliaPosts: 2914 |
David, Dont be sorry, I think the current Manual is VERY good but there is always room for improvement, I take it all on board. As to Open Office... Well I agree.. I use WORD 2007 (which I bought for a reasonable price $99 home and student) and Tsvetan and I have been through this merry dance everytime I did an edit of the manual for him...Every exchange between us had format changes, I ended up having to install OO for consistency. For what its worth Open Office is Good but I hate it in comparison to what i am used to, and I feel is the industry standard (I know this will attract flack and I am NOT a M$ supporter). As to the PDF distribution, I feel that this is the ONLY way to distribute the file as it an across platform standard and will even resize to suit different paper A4, Letter etc. whereas the document will be all over the place if used as Letter as compared to A4. As to Basic files in PDF, I agree too I dont see what benefit it brings seeing they are just text anyway, unless you want to highlight text for emphasis. Regards, Mick PS I finally got around to scanning your AVATAR to see what it said.. Like it  Mick's uMite Stuff can be found >>> HERE (Kindly hosted by Dontronics) <<< |
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
i TOTALLY Agree I am not a MS lover much, but if you are going tp use Word format files use MS-Word OO needs to offer 100% compatibility any thing less is not good enough. Ok having their own ODT format but at least offer .docx format that is 100% compatible. Basic FILES as PDF is just DUMB. I am glad you like the Avatar Anyone wanting QRCODES , I use QRSTUFF.com (no it is not own of my sites) Link to Microsoft .doc format Manual http;//www.duinomite.maximite.com.au/docs/duinomitemanual.do c VK4MU MicroController Units |
||||
crackerjack Senior Member  Joined: 11/07/2011 Location: AustraliaPosts: 164 |
Word processors are nightmarish for keeping and merging multiple revisions of text. Anybody who is interested might want to look at ASCIIDOC (google it). It can be used to create beautiful documentation output to PDF and/or HTML all based on pure ASCII text which is very easy to compare and merge. All that format fiddling becomes a thing of the past. Just a thought for the future. I've used it for years in my professional and hobby documentation undertakings. YMMV. Cheers... |
||||
| DuinoMiteMegaAn Senior Member Joined: 17/11/2011 Location: AustraliaPosts: 231 |
Basic FILES as PDF is just DUMB.
Not unless you want to PROTECT your basic source code, text, instructions from other people from modifying it OR claiming it was theirs. |
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
It takes very little effort for a person wanting to change your source code to convert to text and back to PDF. PDF files are able to be edited, converted to new formats. DO not be lulled into a false sense of security that PDF's are some how immune to copyright Infringements. My point is you should not have to convert to ASCII Text any Basic source code that started life as ASCII Text. Corrected Link to MS Word format Created by the way the from PROTECTED version of the PDF by using standard built-in MS WINDOWS 7 Tools VK4MU MicroController Units |
||||
| JohnS Guru Joined: 18/11/2011 Location: United KingdomPosts: 3800 |
The manual could just about be provided in .doc format but not .docx which is yet another stupid MS change. I've done the dance-of-the-MS-format-incompatibilites-with-their-own-produ cts over many years and anything is better than that. BASIC source should be .bas (or .zip or the like). Copying it from a manual is a bizarre idea, regardless of the manual format. John |
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
EXACTLY VK4MU MicroController Units |
||||
| DuinoMiteMegaAn Senior Member Joined: 17/11/2011 Location: AustraliaPosts: 231 |
Basic FILES as PDF is just DUMB.
BASIC source should be .bas (or .zip or the like).
Is there a text "standard committee" on this forum board that dictates how it should be done ?
In the end, its really up to the user on how he/she chooses to produces his or her basic source text. 
|
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
No "Standards Committee" But as the code started life as ASCII text and Is needed to be used on another computer as ASCII text, why complicate matters by translating to and from another format. Andy, if you want to use PDF's for the clarity of description and formatting, great, but why not include BASIC Source file for actual code sample. Remember some of the Newbies being introduced to the MAXIMITE/DuinoMite & MMBasic on this forum may NOT know or have difficulty in entering the Source Code to try it. [quote]Not unless you want to PROTECT your basic source code, text, instructions from other people from modifying it OR claiming it was theirs.[/quote] Plus COPYRIGHT comes from the Authorship of the content, NOT the FORMAT of the FILE. The concept of copyright is from the creation of the material, notg how you protect or present it. VK4MU MicroController Units |
||||
| DuinoMiteMegaAn Senior Member Joined: 17/11/2011 Location: AustraliaPosts: 231 |
Andy, if you want to use PDF's for the clarity of description and formatting, great, but why not include BASIC Source file for actual code sample.
Talk is cheap ... Actions speaks louder ... Take a gander of all of my complete basic source files of my previous "Precision Time Keeping Project" and please see for yourself! |
||||
| djuqa Guru Joined: 23/11/2011 Location: AustraliaPosts: 447 |
Yes, I have had a look at the project ** EXCELLENT WORK **
VK4MU MicroController Units |
||||
| Page 2 of 2 |
|||||
 Print this page |
