Page 3 of 12 FirstFirst 12345 ... LastLast
Results 21 to 30 of 116

Thread: Seeking feedback on the manual

  1. July 26th, 2005, 02:41 AM #21
    kkirk
    kkirk is offline Member Experienced User
    Join Date
    May 2005
    Posts
    80

    Default

    I managed to read & digest until the scripts section. Some additional comments / observations & suggestions coming from a Girder newbie... Hope this helps. Please take all this is a constructive manner. I really appreciate the work you have done here. Without this manual I am totally lost!!! Thanks

    What are the two numbers seen at the lower left corner of the G4 screen? These are next to the flickering indicators that light up each time a button is pressed. Perhaps a small mention of what these are in the manual would be good.

    Pg 3 - References to LUA - What does LUA stand for anyway? Perhaps a small paragraph on background and references to sites etc.

    Page 7 - Suggest a refreshed screen shot. Should not publish something that refers to fake files etc.

    Page 12 - 2nd paragraph - "this is were actions are defined..." I think you want the word where rather than were in there.

    Page 12 - Last paragraph - Written in a personal dialogue tone. Sugggest a re-write with more technical writing tone. Also try to avoid cramming too much in to the ( ) paranthesis. They distract and break the reading pace.

    Page 18 - First parapgraph - Quite a long & confusing sentence starting ... "If there is no hotkey, or keyboard spoofing... " Suggest re-phrasing this one

    Page 24 - Mid-page - sentence starting "NOTE : ..." Use of the word "thing" does not lend itslef well to a technical publication.

    Page 25 - What is a switch bounce? Could elaborate a little more.

    Page 29 - Can user add a Predefined Event? How? Perhaps including an example would be good.
    Reply With Quote Reply With Quote
  2. July 26th, 2005, 08:51 AM #22
    Promixis's Avatar
    Promixis
    Promixis is offline Senior Member Promixis Team
    Join Date
    Dec 2001
    Posts
    11,560

    Default

    Quote Originally Posted by kkirk
    I managed to read & digest until the scripts section. Some additional comments / observations & suggestions coming from a Girder newbie... Hope this helps. Please take all this is a constructive manner. I really appreciate the work you have done here. Without this manual I am totally lost!!! Thanks

    What are the two numbers seen at the lower left corner of the G4 screen? These are next to the flickering indicators that light up each time a button is pressed. Perhaps a small mention of what these are in the manual would be good.

    Pg 3 - References to LUA - What does LUA stand for anyway? Perhaps a small paragraph on background and references to sites etc.

    Page 7 - Suggest a refreshed screen shot. Should not publish something that refers to fake files etc.

    Page 12 - 2nd paragraph - "this is were actions are defined..." I think you want the word where rather than were in there.

    Page 12 - Last paragraph - Written in a personal dialogue tone. Sugggest a re-write with more technical writing tone. Also try to avoid cramming too much in to the ( ) paranthesis. They distract and break the reading pace.

    Page 18 - First parapgraph - Quite a long & confusing sentence starting ... "If there is no hotkey, or keyboard spoofing... " Suggest re-phrasing this one

    Page 24 - Mid-page - sentence starting "NOTE : ..." Use of the word "thing" does not lend itslef well to a technical publication.

    Page 25 - What is a switch bounce? Could elaborate a little more.

    Page 29 - Can user add a Predefined Event? How? Perhaps including an example would be good.
    Great suggestions, thanks again for the detailed feedback.
    Reply With Quote Reply With Quote
  3. July 26th, 2005, 09:10 AM #23
    kkirk
    kkirk is offline Member Experienced User
    Join Date
    May 2005
    Posts
    80

    Default

    My pleasure. Glad to be of service. As a newbie this is all I can do for now. By the way I love the new term "Expando"! Sounds like a spelll from a Harry Potter book!
    Reply With Quote Reply With Quote
  4. July 27th, 2005, 06:44 PM #24
    Rob H's Avatar
    Rob H
    Rob H is offline Senior Member Promixis Team
    Join Date
    May 2004
    Location
    Cardigan, UK
    Posts
    9,278

    Default

    In the 'Ten things to know about Lua' section - part 7: The help file uses 'nul' where it should use 'nil'.

    Under 'Script containers' - part 2 - currently says 'In files with the GML extension' - that should be 'In files with the lua extension'

    You're also missing documentation on the win.URLDownloadToMemory() function
    --Rob
    Reply With Quote Reply With Quote
  5. July 28th, 2005, 04:11 AM #25
    JohnHind's Avatar
    JohnHind
    JohnHind is offline Senior Member Promixis Team Experienced User
    Join Date
    Mar 2003
    Location
    London, UK
    Posts
    294

    Default

    Many thanks everyone. The comments up to Monday (Except for the Quick Start section which I'm re-writing) have been addressed in the latest version which is with Ron and co.

    Sorry, kkirk, they made me change "expando" to "task box". I'll try to sell "expando" (and the reverse spell "contracto") to J.K. Rowling - she can probably afford to reward me well!

    rah99 - I've fixed your comments today for the next release. File search revealed several nul for nil - trouble is it works just as well in most code since nul is an undefined variable and so has value nil. I reverse engineered win.URLDownloadToMemory to:

    [buffer], [written], [expected] = win.URLDownloadToMemory([URL], [callback])

    buffer being a string to contain the download and the rest being as per DownloadToFile - do you concur? (it seems to work).

    Keep 'em coming!
    Reply With Quote Reply With Quote
  6. July 28th, 2005, 07:40 AM #26
    Rob H's Avatar
    Rob H
    Rob H is offline Senior Member Promixis Team
    Join Date
    May 2004
    Location
    Cardigan, UK
    Posts
    9,278

    Default

    Not sure what the results are from win.URLDownloadToMemory() - you'll have to ask MikeC about that.
    --Rob
    Reply With Quote Reply With Quote
  7. August 1st, 2005, 12:03 AM #27
    danward79's Avatar
    danward79
    danward79 is offline Senior Member Long-Time User
    Join Date
    Nov 2003
    Location
    Hove, E Sussex, UK
    Posts
    4,005

    Default

    Hi,

    In the win table, win.DirectoryExists, should be win.PathExists.

    That one caught me out! :wink:
    Thx, Dan

    Onwards and Upwards!
    http://www.danward.co.uk
    Reply With Quote Reply With Quote
  8. August 1st, 2005, 03:39 AM #28
    kkirk
    kkirk is offline Member Experienced User
    Join Date
    May 2005
    Posts
    80

    Default

    Quote Originally Posted by JohnHind
    Sorry, kkirk, they made me change "expando" to "task box". I'll try to sell "expando" (and the reverse spell "contracto") to J.K. Rowling - she can probably afford to reward me well!
    Oh well, it could last only so long right??? Bye expando... Till we meet again!
    Reply With Quote Reply With Quote
  9. August 2nd, 2005, 02:57 PM #29
    birty
    birty is offline Senior Member Experienced User
    Join Date
    Sep 2003
    Location
    reading / bournemouth UK
    Posts
    1,106

    Default

    in the osd menu section
    Callback: Function taking one parameter, the selected item number.
    should be takes two paramters, the item number and the item name
    Reply With Quote Reply With Quote
  10. August 3rd, 2005, 01:27 AM #30
    kkirk
    kkirk is offline Member Experienced User
    Join Date
    May 2005
    Posts
    80

    Default

    Hi. Will there be an updated version published soon covering the B5 changes and all other feedback? Thanks
    Reply With Quote Reply With Quote
« Previous Thread | Next Thread »

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •  

Forum Rules