Procedure How to Write a Manual!

2009-05-22 Thread Bodvar Bjorgvinsson
I agree that the writer must love the language, but he/she must refrain from using "words such as 'transmogrify'" unless there is a very good reason for it _and_ you have the word explained in the "Terms and Definitions" section. ;-) Have KISS in mind - as much as practicable, when writing technica

Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
There's no doubt something I'm missing here, but for the life of me I don't know what it might be. I have a document with one text flow (A) that has been defined with side-heads, and the side-heads are enabled. I have paragraph tags that are defined as "Across all columns and side-heads". When I

Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Bodvar Bjorgvinsson
Have you had a look at all your Master Pages? There might be one that you are not using but is assigned to text flow (A). Bodvar 2009/5/22 Lin Sims : > There's no doubt something I'm missing here, but for the life of me I > don't know what it might be. > > I have a document with one text flow (A

Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Art Campbell
It isn't clear whether you get the message when you change one particular para format, or any one para format. If it's one particular para format, I'd look for paragraphs of that type that may contain an override and remove it... If it's all para tags, I'd suspect an issue with one or more pages,

[Free Framers] Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
Follow-up based on some off-list responses (thanks, guys). I obviously did not make clear that the Master Page is where I defined the side head, and it is indeed enabled. The document was created from a template containing this master page, so both its master and body pages have side heads. This

Procedure How to Write a Manual!

2009-05-22 Thread Peter Gold
On Fri, May 22, 2009 at 8:36 AM, Bodvar Bjorgvinsson wrote: > I agree that the writer must love the language, but he/she must > refrain from using "words such as 'transmogrify'" unless there is a > very good reason for it _and_ you have the word explained in the > "Terms and Definitions" section.

Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
I get it whenever I update a paragraph format with the property "Across all columns and side heads" turned on. Both Master Pages have side-heads turned on. I am currently looking at a text inset file that has some odd things going on with the frames on the body page not matching the frames on the

Containers and Insets-Building the Manual

2009-05-22 Thread Judy
Jing Torralba wrote: > > I use Richard's technique in creating insets in multiple flows within > the same source document. The insets populate cells of many similar > tables where one table uses 100% of the insets and the rest, only a > subset of all insets in different combinations. The tables

[Free Framers] Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
On Fri, May 22, 2009 at 10:30 AM, Bernd Meissner wrote: > Lin Sims wrote: >> >> I get it whenever I update a paragraph format with the property >> "Across all columns and side heads" turned on. >> >> Both Master Pages have side-heads turned on. > > > Lin, > > there's still a difference between Ma

Procedure How to Write a Manual!

2009-05-22 Thread syed.hos...@aeris.net
Ah ... the old NUXI problem. :) > I also ran into "endian" while documenting a UNIX application. A > subject-matter expert (SME) patiently explained it to me, though my > impression at the time was that he was a little uncertain. Perhaps the > uncertainty was about the explanation itself, not abo

SOLVED! Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
I had my heading paragraph tags on a reference page for easy global updating of JUST the heading tags. That reference page flow did NOT have side heads. Now it does. No more message. Sheesh. On Fri, May 22, 2009 at 10:47 AM, Lin Sims wrote: > > On Fri, May 22, 2009 at 10:30 AM, Bernd Meissner

Add information to registry ?

2009-05-22 Thread Jo Watkiss
Sorry for the long silence on this - been busy. I'm not certain, but I think this message only started when I installed FM9. Off list I've heard that others are getting the same message. I only get the message when opening FM6. I've been selecting 'No' to adding information to the registry. If

Containers and Insets-Building the Manual

2009-05-22 Thread Art Campbell
The item that I thought of that may cause a slow-down is not your local config as much as if all those files and insets are across the network on one or more servers. If they're all open, and you're performing a file-intensive operation, you're going to be using up a lot of bandwidth. I'd try an e

legal notice for new patent in docs?

2009-05-22 Thread obair
Thanks to the folks who sent suggestions. They were very helpful. best, Paul On Thursday, May 21, 2009, at 12:19PM, "Combs, Richard" wrote: >obair wrote: > >> My boss is asking me to do some research to determine the "correct >form of >> legal notice for our patent and how it should be worded

Add Master Page of Different Size

2009-05-22 Thread Nancy Allison

Add Master Page of Different Size

2009-05-22 Thread Nancy Allison
Take 2. Sorry for blank email. Hi, everyone. How do I add a master page that is 11 x 17 in a document that is otherwise 8.5 x 11? If I add the master page and then use Format/Page Layout/Page Size, and change the dimensions there, all the master pages are changed to the new size. Thanks.

Add Master Page of Different Size

2009-05-22 Thread Art Campbell
You can't... The elegant way to do it is to create a second template with the proper page sizes and use that for the 11x17 size. If you need to intermingle the pages in a book, you can do that by setting up the book numbering properties to treat multiple files as a single chapter. Art Art Campbe

Add Master Page of Different Size

2009-05-22 Thread Lin Sims
You can't. Frame doesn't allow multiple page sizes within a file. Could you put it in an appendix and just refer people to it? If it's the last page of the document or the book, you could put it in a separate file and "hard code" the page and chapter numbers, if necessary. Or maybe split your cur

Add Master Page of Different Size

2009-05-22 Thread Owen, Clint
Nancy, As far as I know, you need to create a separate file for each different size master page. You can't mix master page sizes in a file. Clint Clinton Owen | Senior Technical Writer | Crane Aerospace & Electronics | Telephone: +1 425-743-8674 | Fax: +1 425-743-8113 -Original Message-

Add Master Page of Different Size

2009-05-22 Thread Nancy Allison
Thanks, everyone. You're great! --Nancy

Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Jeremy H. Griffith
On Fri, 22 May 2009 13:36:11 +, Bodvar Bjorgvinsson wrote: >Regarding the "endianess", I had a problem some 13 years ago with some >UNIX software that was supposed to work on Linux. It did not. I sent a >query to an Icelandic guy on the "Basic Linux Training" list I >subscribed to and he cam

Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Jeff Coatsworth
Wow! What an education for a Friday ;>) I remember playing with DEC PDP-11's when I was a kid visiting my father's office. I used to play some pseudo-D&D command line game and fool around with some graphics software that would draw overlapping circles & fill them with a limited palette of colours

Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Bodvar Bjorgvinsson
Now I finally understand and, consequently revoke my warning words against using 'endianess' in a manual. :D What? I understand it, why shouldn't everyone else? :-/ B??var -- Enlightened on a Friday 2009/5/22 Jeremy H. Griffith : > On Fri, 22 May 2009 13:36:11 +, Bodvar Bjorgvinsson > wrote

Big and Little Endians

2009-05-22 Thread William Abernathy
This discussion has brought to mind a couple of points of usage. First, the property is (or should be) referred to as "endianness," with two n's. An endianess is a female endian. Second, since there is no country called "Endia," there is no need to capitalize little- or big-endian. Thank you

Motivating end users to read the user manual

2009-05-22 Thread Mike Wickham
> Wheildon's book is rather narrowly addressed to advertisers who > typically need to get a reader's attention in the split second they flip > the pages of a magazine. I don't think it's valid to extrapolate his > conclusions to book length technical documents. (And to read some of > the comments

Procedure How to Write a Manual!

2009-05-22 Thread Gerald Robertson
The wikipedia definition can be found at http://en.wikipedia.org/wiki/Endianness _ Hotmail? goes with you. http://windowslive.com/Tutorial/Hotmail/Mobile?ocid=TXT_TAGLM_WL_HM_Tutorial_Mobile1_052009

Motivating end users to read the manual

2009-05-22 Thread Andy Kass
Hi all, I thought this was an interesting topic, and I wanted to jump in as well. I see three possible issues, listed from easiest to hardest to solve: 1. Despite your efforts, the doc doesn't meet the needs of the field engineers. As others have pointed out, your text can be verbose. Are thes

Procedure How to Write a Manual!

2009-05-22 Thread Andy Kass
I've enjoyed reading all the input on this thread, and I had a few more thoughts. Unfortunately, the way Reid writes it below, it looks like anyone can have the writer role. I would've written: 4. Technical Writer who knows enough to understand the SME, learns about the audience and its lingo,

Motivating users/typography, etc.

2009-05-22 Thread Cal Callahan
Good points, Mike. Let's not forget that devil reverse type (drives me crazy regardless of colors), proper use of sans serif vs. serif type, line length, etc., etc. There are so many considerations regarding document design you could write a book about it. In fact, several people have. A text from

Re: Procedure How to Write a Manual!

2009-05-22 Thread Bodvar Bjorgvinsson
I agree that the writer must love the language, but he/she must refrain from using "words such as 'transmogrify'" unless there is a very good reason for it _and_ you have the word explained in the "Terms and Definitions" section. ;-) Have KISS in mind - as much as practicable, when writing technica

Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
There's no doubt something I'm missing here, but for the life of me I don't know what it might be. I have a document with one text flow (A) that has been defined with side-heads, and the side-heads are enabled. I have paragraph tags that are defined as "Across all columns and side-heads". When I

Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Bodvar Bjorgvinsson
Have you had a look at all your Master Pages? There might be one that you are not using but is assigned to text flow (A). Bodvar 2009/5/22 Lin Sims : > There's no doubt something I'm missing here, but for the life of me I > don't know what it might be. > > I have a document with one text flow (A

Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Art Campbell
It isn't clear whether you get the message when you change one particular para format, or any one para format. If it's one particular para format, I'd look for paragraphs of that type that may contain an override and remove it... If it's all para tags, I'd suspect an issue with one or more pages,

Re: [Free Framers] Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
Follow-up based on some off-list responses (thanks, guys). I obviously did not make clear that the Master Page is where I defined the side head, and it is indeed enabled. The document was created from a template containing this master page, so both its master and body pages have side heads. This

Re: Procedure How to Write a Manual!

2009-05-22 Thread Peter Gold
On Fri, May 22, 2009 at 8:36 AM, Bodvar Bjorgvinsson wrote: > I agree that the writer must love the language, but he/she must > refrain from using "words such as 'transmogrify'" unless there is a > very good reason for it _and_ you have the word explained in the > "Terms and Definitions" section.

Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
I get it whenever I update a paragraph format with the property "Across all columns and side heads" turned on. Both Master Pages have side-heads turned on. I am currently looking at a text inset file that has some odd things going on with the frames on the body page not matching the frames on the

Re: Containers and Insets-Building the Manual

2009-05-22 Thread Judy
Jing Torralba wrote: > > I use Richard's technique in creating insets in multiple flows within > the same source document. The insets populate cells of many similar > tables where one table uses 100% of the insets and the rest, only a > subset of all insets in different combinations. The tables

Re: [Free Framers] Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
On Fri, May 22, 2009 at 10:30 AM, Bernd Meissner wrote: > Lin Sims wrote: >> >> I get it whenever I update a paragraph format with the property >> "Across all columns and side heads" turned on. >> >> Both Master Pages have side-heads turned on. > > > Lin, > > there's still a difference between Ma

RE: Procedure How to Write a Manual!

2009-05-22 Thread Syed.Hosain
Ah ... the old NUXI problem. :) > I also ran into "endian" while documenting a UNIX application. A > subject-matter expert (SME) patiently explained it to me, though my > impression at the time was that he was a little uncertain. Perhaps the > uncertainty was about the explanation itself, not abo

SOLVED! Re: Error when updating Side-head tag in flow WITH side-heads

2009-05-22 Thread Lin Sims
I had my heading paragraph tags on a reference page for easy global updating of JUST the heading tags. That reference page flow did NOT have side heads. Now it does. No more message. Sheesh. On Fri, May 22, 2009 at 10:47 AM, Lin Sims wrote: > > On Fri, May 22, 2009 at 10:30 AM, Bernd Meissner

RE: Add information to registry ?

2009-05-22 Thread Jo Watkiss
Sorry for the long silence on this - been busy. I'm not certain, but I think this message only started when I installed FM9. Off list I've heard that others are getting the same message. I only get the message when opening FM6. I've been selecting 'No' to adding information to the registry. If

Re: Containers and Insets-Building the Manual

2009-05-22 Thread Art Campbell
The item that I thought of that may cause a slow-down is not your local config as much as if all those files and insets are across the network on one or more servers. If they're all open, and you're performing a file-intensive operation, you're going to be using up a lot of bandwidth. I'd try an e

RE: legal notice for new patent in docs?

2009-05-22 Thread obair
Thanks to the folks who sent suggestions. They were very helpful. best, Paul On Thursday, May 21, 2009, at 12:19PM, "Combs, Richard" wrote: >obair wrote: > >> My boss is asking me to do some research to determine the "correct >form of >> legal notice for our patent and how it should be worde

Add Master Page of Different Size

2009-05-22 Thread Nancy Allison
___ 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/

Add Master Page of Different Size

2009-05-22 Thread Nancy Allison
Take 2. Sorry for blank email. Hi, everyone. How do I add a master page that is 11 x 17 in a document that is otherwise 8.5 x 11? If I add the master page and then use Format/Page Layout/Page Size, and change the dimensions there, all the master pages are changed to the new size. Thanks. _

Re: Add Master Page of Different Size

2009-05-22 Thread Art Campbell
You can't... The elegant way to do it is to create a second template with the proper page sizes and use that for the 11x17 size. If you need to intermingle the pages in a book, you can do that by setting up the book numbering properties to treat multiple files as a single chapter. Art Art Campbe

Re: Add Master Page of Different Size

2009-05-22 Thread Lin Sims
You can't. Frame doesn't allow multiple page sizes within a file. Could you put it in an appendix and just refer people to it? If it's the last page of the document or the book, you could put it in a separate file and "hard code" the page and chapter numbers, if necessary. Or maybe split your cur

RE: Add Master Page of Different Size

2009-05-22 Thread Owen, Clint
Nancy, As far as I know, you need to create a separate file for each different size master page. You can't mix master page sizes in a file. Clint Clinton Owen | Senior Technical Writer | Crane Aerospace & Electronics | Telephone: +1 425-743-8674 | Fax: +1 425-743-8113 -Original Message-

Re: Add Master Page of Different Size

2009-05-22 Thread Nancy Allison
Thanks, everyone. You're great! --Nancy ___ 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 vis

Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Jeremy H. Griffith
On Fri, 22 May 2009 13:36:11 +, Bodvar Bjorgvinsson wrote: >Regarding the "endianess", I had a problem some 13 years ago with some >UNIX software that was supposed to work on Linux. It did not. I sent a >query to an Icelandic guy on the "Basic Linux Training" list I >subscribed to and he cam

RE: Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Jeff Coatsworth
Wow! What an education for a Friday ;>) I remember playing with DEC PDP-11's when I was a kid visiting my father's office. I used to play some pseudo-D&D command line game and fool around with some graphics software that would draw overlapping circles & fill them with a limited palette of colours

Re: Big and Little Endians [was: Re: Procedure How to Write a Manual!]

2009-05-22 Thread Bodvar Bjorgvinsson
Now I finally understand and, consequently revoke my warning words against using 'endianess' in a manual. :D What? I understand it, why shouldn't everyone else? :-/ Böðvar -- Enlightened on a Friday 2009/5/22 Jeremy H. Griffith : > On Fri, 22 May 2009 13:36:11 +, Bodvar Bjorgvinsson > wrote

Re: Big and Little Endians

2009-05-22 Thread William Abernathy
This discussion has brought to mind a couple of points of usage. First, the property is (or should be) referred to as "endianness," with two n's. An endianess is a female endian. Second, since there is no country called "Endia," there is no need to capitalize little- or big-endian. Thank you

Re: Motivating end users to read the user manual

2009-05-22 Thread Mike Wickham
> Wheildon's book is rather narrowly addressed to advertisers who > typically need to get a reader's attention in the split second they flip > the pages of a magazine. I don't think it's valid to extrapolate his > conclusions to book length technical documents. (And to read some of > the comments