Mentioning open source softwares
Dear all, is there any rule about how to mention open source software in technical documentation? The software I am currently documenting (MashUp Composer) requires from users that they run a database creation script. To do so, they need to launch a DB administration tool such as MySQL Administrator and MySQL Qury Browser to set user privileges, create the required DB schema, run the script, etc. How would you recommend to present things? Can I say, for example: Launch your favorite DB administration tool (for example MySQL Administrator). Am I supposed to add copyright mentions for open source software? Any help is greatly appreciated! Cheers, Mathieu. _ Téléchargez Internet Explorer 8 et surfez sans laisser de trace ! http://clk.atdmt.com/FRM/go/182932252/direct/01/ ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: Ctrl key issues
I'd suspect something on the laptop because it happens for different aps. When something like this has occurred on one of my systems, I usually find that it's ClipMate, SnagIt, or another add-in grabbing keystrokes before Frame can get to them. If you have any aps that you know have hot keys running, you may want to disable them one at a time to ID the culprit. Art Art Campbell art.campb...@gmail.com ... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl. -- Richard Thompson No disclaimers apply. DoD 358 On Thu, Nov 26, 2009 at 11:51 PM, Corinne Kenney skiken...@yahoo.comwrote: FM 9 and FM 7.2 / Windows XP Pro Have battled with this over a year, and 3 laptops. My Ctrl keys stop working after about 15-20 minutes or less. No Ctrl + Z, X, C, M, and so on. Has anyone had this problem? Is it a setting within the laptop, or what? Any help is greatly appreciated. Corinne Kenney, Product Documentation OpenTV Golden CO ___ You are currently subscribed to Framers as art.campb...@gmail.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info. ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: Ctrl key issues
Actually, it happens ONLY in Frame. Other apps work fine. And it has followed me over three laptops. It's weird --- On Fri, 11/27/09, Art Campbell art.campb...@gmail.com wrote: From: Art Campbell art.campb...@gmail.com Subject: Re: Ctrl key issues To: Corinne Kenney skiken...@yahoo.com Cc: framers@lists.frameusers.com Date: Friday, November 27, 2009, 11:03 AM I'd suspect something on the laptop because it happens for different aps. When something like this has occurred on one of my systems, I usually find that it's ClipMate, SnagIt, or another add-in grabbing keystrokes before Frame can get to them. If you have any aps that you know have hot keys running, you may want to disable them one at a time to ID the culprit. Art Art Campbell art.campb...@gmail.com ... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl. -- Richard Thompson No disclaimers apply. DoD 358 On Thu, Nov 26, 2009 at 11:51 PM, Corinne Kenney skiken...@yahoo.com wrote: FM 9 and FM 7.2 / Windows XP Pro Have battled with this over a year, and 3 laptops. My Ctrl keys stop working after about 15-20 minutes or less. No Ctrl + Z, X, C, M, and so on. Has anyone had this problem? Is it a setting within the laptop, or what? Any help is greatly appreciated. Corinne Kenney, Product Documentation OpenTV Golden CO ___ You are currently subscribed to Framers as art.campb...@gmail.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info. ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: Mentioning open source softwares
At 12:41 AM 28/11/2009, mathieu jacquet wrote: Dear all, is there any rule about how to mention open source software in technical documentation? Open source means that the source code of the software is available to anyone under a licence. Its terms and restrictions apply to the usage of the *source code* of that software (compiling it into your own software products), not to the usage of binaries. If you have used an open source toolkit to develop the documentation then it is good manners to include a colophon acknowledging that usage and providing a URL to the main page of the project. It is not a legal requirement. The software I am currently documenting (MashUp Composer) requires from users that they run a database creation script. To do so, they need to launch a DB administration tool such as MySQL Administrator and MySQL Qury Browser to set user privileges, create the required DB schema, run the script, etc. How would you recommend to present things? As above. However, since MySQL is now owned by one of the proprietary software heavies, you should read the licences of those applications to find out whether Oracle has any legal requirement regarding the use of the *trademark* in documentary references. Can I say, for example: Launch your favorite DB administration tool (for example MySQL Administrator). Am I supposed to add copyright mentions for open source software? Don't confuse copyright (which affects the re-use of *written* content and is statutory and governed by international treaties) with trademark usage rules, nor with licence requirements (which are unilateral rules stated by the vendor of the software, to which you agree when installing or compiling that software). -- If you are re-quoting written content from MySQL manuals in your works then you must, under copyright law, acknowledge the source, just as you must do with regard to any other publication from which you lift content. Whether you do this using footnotes or a References section (or a combination of both) is up to you. -- If you are quoting the name of a product in your documentation then you *might* be required to tag the name with the registered trademark symbol (the letter R in a circle, usually superscribed) or the trademark applied for symbol (the letters TM in upper case, usually superscribed). If nothing is mentioned to this effect in your licence agreement then don't include them. Helen ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Re: Ctrl key issues
hi Corinne, do you happen to have alternate keyboard layouts configured on your system, other than the basic English (United States)? I have a few and I found that the one I use most often — a customized version of the French (Canada) layout that includes Unicode characters (i.e. Esperanto's accented letters) — interferes with the keyboard shortcuts *in FrameMaker only*. Soon after installing this keyboard layout, I realized I could not use Ctrl+Shift+V in FrameMaker anymore (nothing happens). At first I thought I would have to uninstall this custom layout and do without it, but then it dawned on me that I might as well just switch to English (Canada) by pressing Left Alt + Shift, the first time I need the shortcuts in FM. (I just cannot use FrameMaker to write in Esperanto.) all this to say... could it be that your Ctrl keys stop working as soon as, somehow, you pressed Left Alt + Shift (unknowingly)? Maybe check your Regional Options control panel, the text services configured on your system, and the language bar preferences... See if just pressing Left Alt + Shift once or twice could revive your Ctrl keys... it could also be something else... For instance, when I was using Remote Desktop Connection to acces a computer at work from my home computer, I would always end up losing both the Ctrl keys and the Shift keys at some point. Sometimes, just repeatedly going Left Ctrl, Right Ctrl a few times, and then Left Shift, Right Shift a few more times would revive the lost keys. (Appartently this was a known issue with Remote Desktop, at least at the time.) FWIW Suzanne Corinne Kenney wrote: Actually, it happens ONLY in Frame. Other apps work fine. And it has followed me over three laptops. It's weird --- On Fri, 11/27/09, Art Campbell art.campb...@gmail.com wrote: From: Art Campbell art.campb...@gmail.com Date: Friday, November 27, 2009, 11:03 AM When something like this has occurred on one of my systems, I usually find that it's ClipMate, SnagIt, or another add-in grabbing keystrokes before Frame can get to them. On Thu, Nov 26, 2009 at 11:51 PM, Corinne Kenney wrote: FM 9 and FM 7.2 / Windows XP Pro Have battled with this over a year, and 3 laptops. My Ctrl keys stop working after about 15-20 minutes or less. No Ctrl + Z, X, C, M, and so on. ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com. To unsubscribe send a blank email to framers-unsubscr...@lists.frameusers.com or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to listad...@frameusers.com. Visit http://www.frameusers.com/ for more resources and info.
Ctrl key issues
I'd suspect something on the laptop because it happens for different aps. When something like this has occurred on one of my systems, I usually find that it's ClipMate, SnagIt, or another add-in grabbing keystrokes before Frame can get to them. If you have any aps that you know have hot keys running, you may want to disable them one at a time to ID the culprit. Art Art Campbell art.campbell at gmail.com "... In my opinion, there's nothing in this world beats a '52 Vincent and a redheaded girl." -- Richard Thompson No disclaimers apply. DoD 358 On Thu, Nov 26, 2009 at 11:51 PM, Corinne Kenney wrote: > FM 9 and FM 7.2 / Windows XP Pro > > Have battled with this over a year, and 3 laptops. My Ctrl keys stop > working after about 15-20 minutes or less. No Ctrl + Z, X, C, M, and so on. > Has anyone had this problem? Is it a setting within the laptop, or what? > > Any help is greatly appreciated. > > Corinne Kenney, Product Documentation > OpenTV > Golden CO > > > > ___ > > > You are currently subscribed to Framers as art.campbell at gmail.com. > > Send list messages to framers at lists.frameusers.com. > > To unsubscribe send a blank email to > framers-unsubscribe at lists.frameusers.com > or visit > http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com > > Send administrative questions to listadmin at frameusers.com. Visit > http://www.frameusers.com/ for more resources and info. >
Ctrl key issues
Actually, it happens ONLY in Frame. Other apps work fine. And it has followed me over three laptops. It's weird --- On Fri, 11/27/09, Art Campbell wrote: > From: Art Campbell > Subject: Re: Ctrl key issues > To: "Corinne Kenney" > Cc: framers at lists.frameusers.com > Date: Friday, November 27, 2009, 11:03 AM > I'd suspect something on the laptop > because it happens for different aps. > When something like this has occurred on one of my systems, > I usually find that it's ClipMate, SnagIt, or another > add-in grabbing keystrokes before Frame can get to them. > > > If you have any aps that you know have hot keys running, > you may want to disable them one at a time to ID the > culprit. > > Art > > Art Campbell ? ? ? ? ? ? ? ? ? ? > ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? > ? ? ? ? ? ? ?art.campbell at gmail.com > > > ?"... In my opinion, there's nothing in this > world beats a '52 Vincent and a redheaded girl." -- > Richard Thompson > ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? > ? ? ? ? ? ? ? ?No disclaimers apply. > ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? > ? ? ? ? ? ? ? ? ? ? ? ? DoD 358 > > > > > > On Thu, Nov 26, 2009 at 11:51 PM, > Corinne Kenney > wrote: > > > FM 9 and FM 7.2 / Windows XP Pro > > > > Have battled with this over a year, and 3 laptops. My Ctrl > keys stop working after about 15-20 minutes or less. No Ctrl > + Z, X, C, M, and so on. Has anyone had this problem? Is it > a setting within the laptop, or what? > > > > > > Any help is greatly appreciated. > > > > Corinne Kenney, Product Documentation > > OpenTV > > Golden CO > > > > > > > > ___ > > > > > > You are currently subscribed to Framers as art.campbell at gmail.com. > > > > Send list messages to framers at lists.frameusers.com. > > > > To unsubscribe send a blank email to > > framers-unsubscribe at lists.frameusers.com > > or visit > http://lists.frameusers.com/mailman/options/framers/art.campbell%40gmail.com > > > > Send administrative questions to listadmin at frameusers.com. > Visit > > http://www.frameusers.com/ > for more resources and info. > > > >