[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Changes to windows.texi
From: |
Eli Zaretskii |
Subject: |
Re: Changes to windows.texi |
Date: |
Sat, 08 Nov 2008 22:16:08 +0200 |
> Date: Sat, 08 Nov 2008 20:56:57 +0100
> From: martin rudalics <address@hidden>
> CC: address@hidden
>
> Many thanks for looking into this.
And many thanks for making the changes in the first place.
> Here makeinfo (GNU texinfo - 4.8) does not capitalize the S for @xref,
> so I was not aware of any such a problem. Or does it capitalize them
> only in the printed manual?
It should capitalize them everywhere. Are you sure it doesn't for
you? Not even at the beginning of a sentence?
> > Another potential issue is as in this example, which is a full
> > sentence:
> >
> > @var{window} defaults to the selected window.
> >
> > This makes "window", starting with a lower-case w, begin a sentence,
> > which might look like a typo in the printed manual. (In the Info
> > manual, @var upcases its argument, so the problem is not visible.)
> > the original text was
> >
> > If @var{window} is omitted, this function returns the buffer for the
> > selected window.
> >
> > and thus didn't have this problem. I didn't fix these sentences.
>
> The problem is that I would have to write
>
> If @var{window} is omitted or @code{nil}, this function returns the
> buffer for the selected window.
>
> to be correct, which means the sentence gets twice as long. And there
> are many instances of that. Writing
>
> If @var{window} is omitted or @code{nil}, the selected window is
> used.
>
> doesn't strike me as elegant either. Anyway, I'll try to fix these
> somehow.
I suggest
The default for @var{window} is the selected window.
> > I also don't understand why you removed paragraph indentation as in
> > this example:
> >
> > - Here is how you can determine whether a given position @var{position}
> > -is off the screen due to horizontal scrolling:
> > +Here is how you can determine whether a given position @var{position} is
> > +off the screen due to horizontal scrolling:
> >
> > I didn't fix these, either.
>
> This must have happened when I refilled them. I shall look into this.
>
> Are such indentations necessary for formatting or are they a stylistic
> convention?
I think it's a convention to have the first paragraph of a section not
to be indented, and indent all the others, although the manual is not
always consistent in this.
Richard, could you please answer this question?
> That is, makeinfo produces them anyway
What makeinfo does is controlled by @firstparagraphindent and
@paragraphindent.
- Changes to windows.texi, martin rudalics, 2008/11/07
- Re: Changes to windows.texi, Eli Zaretskii, 2008/11/08
- Re: Changes to windows.texi, martin rudalics, 2008/11/08
- Re: Changes to windows.texi,
Eli Zaretskii <=
- Re: Changes to windows.texi, martin rudalics, 2008/11/08
- Re: Changes to windows.texi, Eli Zaretskii, 2008/11/08
- Re: Changes to windows.texi, Richard M. Stallman, 2008/11/09
- Re: Changes to windows.texi, Eli Zaretskii, 2008/11/09
- Re: Changes to windows.texi, Richard M. Stallman, 2008/11/10
Re: Changes to windows.texi, Richard M. Stallman, 2008/11/09