GNOME Terminal Documentation

[Paul Cutler-2]

Hi, I'm working on updating the GNOME Terminal documentation, which
last updated by Christian Persch in December.

I didn't see a mailing list for GNOME Terminal, and wasn't sure where
to ask, so if this isn't the right place, please let me know.

My goals for updating the docs for GNOME Terminal are:

* Make GNOME Terminal docs compatible with Pulse
(http://www.gnome.org/~shaunm/pulse/web/doc/svn.gnome.org/gnome-terminal/gnome-terminal/trunk)
* Update "About This Document"
* Update the description / metadata per Bug 500563 from the GHOP
Contest: http://bugzilla.gnome.org/show_bug.cgi?id=500563
* Bug 544101 (Custom Command documentation)  I need some help with
this one.  Looking at the second comment in Bugzilla, I'm not really
sure what the bug report is asking to be documented as it relates to
GNOME Terminal's current behavior.  The documentation currently
states:

Run a custom command instead of my shell

                      Select this option to run a specified command,
other than the normal shell, in the terminal. Specify the custom
command in the Custom command text box.

I almost think that for users who go into the Preferences of GNOME
Terminal to set a custom command that runs instead of the shell, they
probably know what they're doing and the current documentation is good
enough.  Thoughts?

Also, does anyone have any other updates that need to be applied in
the GNOME Terminal docs?

Thanks.

Paul
_______________________________________________
gnome-devel-list mailing list
gnome-devel-list@...
http://mail.gnome.org/mailman/listinfo/gnome-devel-list

[Shaun McCance-2]

On Thu, 2009-03-26 at 16:37 -0500, Paul Cutler wrote:
> Hi, I'm working on updating the GNOME Terminal documentation, which
> last updated by Christian Persch in December.

I went ahead and committed a releaseinfo marking the
document as "review".  Let's get these changes in and
the document reviewed before 2.26.1.

Paul and any other documentation folks: please submit
reviews or patches to bugzilla and ping the mailing
list.  I or someone else will try to look over them
as quickly as possible.

Everybody please note that gnome-terminal has branched,
so you should work from the gnome-2-26 branch:

svn.gnome.org/svn/gnome-terminal/branches/gnome-2-26

Anybody committing patches should make sure to commit
them to both gnome-2-26 and trunk.

Behdad and Christian, could one of you do a technical
review of the documentation please?  You're looking for
technical accuracy and completeness.  What we need to
know from you is whether everything the documentation
says is true, and whether it covers any new features
that may have been added.  You don't need to worry
about language or markup.

Thanks for your time.

--
Shaun


_______________________________________________
gnome-devel-list mailing list
gnome-devel-list@...
http://mail.gnome.org/mailman/listinfo/gnome-devel-list

[Paul Cutler-2]

I'll have a patch later tonight for GNOME Terminal.  I fixed some of
the markup as well, and I have the bug fix in.

On Thu, Mar 26, 2009 at 5:14 PM, Shaun McCance <shaunm@...> wrote:

> On Thu, 2009-03-26 at 16:37 -0500, Paul Cutler wrote:
>> Hi, I'm working on updating the GNOME Terminal documentation, which
>> last updated by Christian Persch in December.
>
> I went ahead and committed a releaseinfo marking the
> document as "review".  Let's get these changes in and
> the document reviewed before 2.26.1.
>
> Paul and any other documentation folks: please submit
> reviews or patches to bugzilla and ping the mailing
> list.  I or someone else will try to look over them
> as quickly as possible.
>
> Everybody please note that gnome-terminal has branched,
> so you should work from the gnome-2-26 branch:
>
> svn.gnome.org/svn/gnome-terminal/branches/gnome-2-26
>
> Anybody committing patches should make sure to commit
> them to both gnome-2-26 and trunk.
>
> Behdad and Christian, could one of you do a technical
> review of the documentation please?  You're looking for
> technical accuracy and completeness.  What we need to
> know from you is whether everything the documentation
> says is true, and whether it covers any new features
> that may have been added.  You don't need to worry
> about language or markup.
>
> Thanks for your time.
>
> --
> Shaun
>
>
>

_______________________________________________
gnome-devel-list mailing list
gnome-devel-list@...
http://mail.gnome.org/mailman/listinfo/gnome-devel-list

[Paul Cutler-2]

The patch is attached to Bug 550563:

http://bugzilla.gnome.org/show_bug.cgi?id=500563

This patch fixes that bug (metadata), some markup fixes, including
authors, section tags to make the file easier to read, and the
releaseinfo markup for Pulse.

Paul

On Thu, Mar 26, 2009 at 5:32 PM, Paul Cutler <pcutler@...> wrote:

> I'll have a patch later tonight for GNOME Terminal.  I fixed some of
> the markup as well, and I have the bug fix in.
>
> On Thu, Mar 26, 2009 at 5:14 PM, Shaun McCance <shaunm@...> wrote:
>> On Thu, 2009-03-26 at 16:37 -0500, Paul Cutler wrote:
>>> Hi, I'm working on updating the GNOME Terminal documentation, which
>>> last updated by Christian Persch in December.
>>
>> I went ahead and committed a releaseinfo marking the
>> document as "review".  Let's get these changes in and
>> the document reviewed before 2.26.1.
>>
>> Paul and any other documentation folks: please submit
>> reviews or patches to bugzilla and ping the mailing
>> list.  I or someone else will try to look over them
>> as quickly as possible.
>>
>> Everybody please note that gnome-terminal has branched,
>> so you should work from the gnome-2-26 branch:
>>
>> svn.gnome.org/svn/gnome-terminal/branches/gnome-2-26
>>
>> Anybody committing patches should make sure to commit
>> them to both gnome-2-26 and trunk.
>>
>> Behdad and Christian, could one of you do a technical
>> review of the documentation please?  You're looking for
>> technical accuracy and completeness.  What we need to
>> know from you is whether everything the documentation
>> says is true, and whether it covers any new features
>> that may have been added.  You don't need to worry
>> about language or markup.
>>
>> Thanks for your time.
>>
>> --
>> Shaun
>>
>>
>>
>

_______________________________________________
gnome-devel-list mailing list
gnome-devel-list@...
http://mail.gnome.org/mailman/listinfo/gnome-devel-list