|
Replies:
1
-
Last Post:
Nov 18, 2009 8:28 AM
by: jyothi
|
|
|
Posts:
98
From:
ES
Registered:
11/4/08
|
|
|
|
OS2009.06 - IPS (DOC) - Issues
Posted:
Nov 17, 2009 6:32 PM
To: Communities » documentation » discuss
|
|
Hi All,
I'm currently translating "OpenSolaris 2009.06 Image Packaging System Guide" into catalan language by using openCTI tool.
I think that I have found various issues on original documentation:
[b]1st issue[/b] is located in chapter: "Advanced IPS commads", section:"Overview of pkg.depot server", table:"5.8-pkg.depotd(1M) options". Missing arguments at 1st row (Option) on "pkg.depotd(1M) options" table.
--writable-root [b]path[/b]
--ssl-key-file [b]source[/b]
--ssl-dialog [b]type[/b]
--ssl-cert-file [b]source[/b]
[1] http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/depot_server.html
[b]2nd issue[/b]: Terminology: pkg(1) Comand reference
[b]bad[/b]: Does not attempt to contact the image's [b]authorities[/b] to retrieve their [b]catalogs[/b].
[b]suggested[/b]: Does not attempt to contact the image's [b]publishers[/b] to retrieve their [b]catalogues[/b].
[b]cause[/b]: Terminology was changed on OS2009.06, authority term has to be changed with publisher term.
catalog [en_US] -> catalogue [EN_GB]
[2]: http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/gentextid-2539.html
[b]3rd Issue[/b]: IPS FAQ: Inconsistency
[b]Source[/b]: "Use the Package Manager (which is the Graphical User Interface for IPS) to install packages from the command line."
[b]Inconsistency[/b]: Package Manager is a GUI client of IPS. pkg(1) is a CLI client of IPS.
[b]4th Issue[/b]: IPS-FAQ: Doubt
What is the meaning of (jo_todo)?
[b]Source[/b]: "See the {4}Package Manager{5} section or Working With Packages section (jo_todo) for information."
[b]Idea[/b]: Is job to do?
Regards,
Robert
|
|
|
Posts:
37
From:
US
Registered:
3/22/07
|
|
|
|
Re: [docs-discuss] OS2009.06 - IPS (DOC) - Issues
Posted:
Nov 18, 2009 8:28 AM
in response to: rbuj
|
|
On 11/17/09 18:32, Robert Buj Gelonch wrote:
> Hi All,
>
> I'm currently translating "OpenSolaris 2009.06 Image Packaging System Guide" into catalan language by using openCTI tool.
>
> I think that I have found various issues on original documentation:
>
> [b]1st issue[/b] is located in chapter: "Advanced IPS commads", section:"Overview of pkg.depot server", table:"5.8-pkg.depotd(1M) options". Missing arguments at 1st row (Option) on "pkg.depotd(1M) options" table.
>
> --writable-root [b]path[/b]
> --ssl-key-file [b]source[/b]
> --ssl-dialog [b]type[/b]
> --ssl-cert-file [b]source[/b]
>
> [1] http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/depot_server.html
>
> [b]2nd issue[/b]: Terminology: pkg(1) Comand reference
>
> [b]bad[/b]: Does not attempt to contact the image's [b]authorities[/b] to retrieve their [b]catalogs[/b].
> [b]suggested[/b]: Does not attempt to contact the image's [b]publishers[/b] to retrieve their [b]catalogues[/b].
> [b]cause[/b]: Terminology was changed on OS2009.06, authority term has to be changed with publisher term.
> catalog [en_US] -> catalogue [EN_GB]
>
> [2]: http://dlc.sun.com/osol/docs/content/2009.06/IMGPACKAGESYS/gentextid-2539.html
>
> [b]3rd Issue[/b]: IPS FAQ: Inconsistency
>
> [b]Source[/b]: "Use the Package Manager (which is the Graphical User Interface for IPS) to install packages from the command line."
> [b]Inconsistency[/b]: Package Manager is a GUI client of IPS. pkg(1) is a CLI client of IPS.
>
> [b]4th Issue[/b]: IPS-FAQ: Doubt
>
> What is the meaning of (jo_todo)?
>
> [b]Source[/b]: "See the {4}Package Manager{5} section or Working With Packages section (jo_todo) for information."
> [b]Idea[/b]: Is job to do?
>
> Regards,
>
> Robert
>
Hi Robert,
I am the writer for the IPS USer Guide. Thanks for pointing out some of
the errors in the document.
I will correct them as I update the doc for 2010.03.
Also, are you looking at the xml file for translation? The last couple
of issues are probably under "Writer Remarks", which does not show up in
the final doc. Can you see the "Writer Remarks" tag? These should not be
translated.
Thanks,
Jyothi
_______________________________________________
docs-discuss mailing list
docs-discuss at opensolaris dot org
|
|
|
|
|
