[Esbox-commits] r1651 - in branches/work_Ed/org.maemo.esbox.help/html: concepts images images/debian images/externalize tasks

eswartz at garage.maemo.org eswartz at garage.maemo.org
Wed May 27 17:10:52 EEST 2009


Author: eswartz
Date: 2009-05-27 17:10:50 +0300 (Wed, 27 May 2009)
New Revision: 1651

Added:
   branches/work_Ed/org.maemo.esbox.help/html/images/debian/dialog-debian-content-reader.png
   branches/work_Ed/org.maemo.esbox.help/html/images/debian/dialog-debian-content-viewer.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-menu.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-select.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-translate.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-view.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/never_translate.gif
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/skip.gif
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/translate.gif
Removed:
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-menu.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-select.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-translate.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-view.png
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/never_translate.gif
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/skip.gif
   branches/work_Ed/org.maemo.esbox.help/html/images/externalize/translate.gif
   branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings.png
   branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings1.png
   branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings2.png
Modified:
   branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html
   branches/work_Ed/org.maemo.esbox.help/html/images/menu-debian-package.png
   branches/work_Ed/org.maemo.esbox.help/html/tasks/DebianPackage.html
   branches/work_Ed/org.maemo.esbox.help/html/tasks/ExternalizeString.html
Log:
Merge revs 1636:1650 from trunk

Modified: branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html	2009-05-27 02:43:26 UTC (rev 1650)
+++ branches/work_Ed/org.maemo.esbox.help/html/concepts/DebianPackage.html	2009-05-27 14:10:50 UTC (rev 1651)
@@ -58,7 +58,7 @@
 <h3>Building packages</h3>
 
 <p>To build packages, use the <em>Debian Package &gt; Build Debian Package</em>
-wizard.  
+wizard. After a successfully build there will be shown content of the built Debian package.   
 
 <h3>Deploying packages</h3>
 
@@ -69,6 +69,11 @@
 		<p>
 		See <a href="http://www.debian.org/doc/FAQ/ch-pkg_basics.en.html">Basics of the Debian package management system</a> for details about Debian packaging.
 </p>
+
+<h3>Investigating Debian package content</h3>
+
+<p>To investigate content of the Debian package, use the <em>Debian Package &gt; Show Debian package content</em> dialog. 
+It provides to investigate content of a selected Debian package. There are list of ten last shown Debian package of each project.
 	
         <h3>Related Topic</h3>
 <ul>

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/debian/dialog-debian-content-reader.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/debian/dialog-debian-content-reader.png)
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/debian/dialog-debian-content-viewer.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/debian/dialog-debian-content-viewer.png)
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-menu.png
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-menu.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/es-menu.png)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-select.png
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-select.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/es-select.png)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-translate.png
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-translate.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/es-translate.png)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-view.png
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/es-view.png (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/es-view.png)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/never_translate.gif
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/never_translate.gif (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/never_translate.gif)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/skip.gif
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/skip.gif (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/skip.gif)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/translate.gif
===================================================================
(Binary files differ)

Copied: branches/work_Ed/org.maemo.esbox.help/html/images/externalize/translate.gif (from rev 1650, trunk/org.maemo.esbox.help/html/images/externalize/translate.gif)
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings.png
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings1.png
===================================================================
(Binary files differ)

Deleted: branches/work_Ed/org.maemo.esbox.help/html/images/extractstrings2.png
===================================================================
(Binary files differ)

Modified: branches/work_Ed/org.maemo.esbox.help/html/images/menu-debian-package.png
===================================================================
(Binary files differ)

Modified: branches/work_Ed/org.maemo.esbox.help/html/tasks/DebianPackage.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/tasks/DebianPackage.html	2009-05-27 02:43:26 UTC (rev 1650)
+++ branches/work_Ed/org.maemo.esbox.help/html/tasks/DebianPackage.html	2009-05-27 14:10:50 UTC (rev 1651)
@@ -41,8 +41,9 @@
 <img src="../images/menu-debian-package.png" alt="Debian Package menu" />	</p>
   </li>
 	
-	<li>The package will be built, with results reported to the Console view.</li>
-
+	<li>The package will be built, with results reported to the Console view. If the package is built successfully content of the Debian package will be shown.</li>
+	<p>
+	<img src="../images/debian/dialog-debian-content-reader.png" alt="Debian Package Reader" />	</p>
 </ol>
 
 <h4 class="style1"><br>
@@ -77,5 +78,21 @@
 	  
 	<li>The results of the operation are reported in the Console view.</li>
 </ol>
+
+<h3 class="style1">Investigate Debian Package contents</h3>
+<ol>
+
+  <li>Select a project, right-click and select <strong>Debian&nbsp;Package</strong> in the popup menu.</li>
+
+  <li>Click on <strong>Show&nbsp;Debian&nbsp;Package&nbsp;Contents</strong>.
+	
+	<p>
+<img src="../images/menu-debian-package.png" alt="Debian Package menu" />	</p>
+  </li>
+	
+	<li>The viewer provides to select a *.deb file and shows contents of the selected package. There are list of ten last shown Debian packages of each project.</li>
+	<p>
+	<img src="../images/debian/dialog-debian-content-viewer.png" alt="Debian Package Viewer" />	</p>
+</ol>
 </body>
 </html>

Modified: branches/work_Ed/org.maemo.esbox.help/html/tasks/ExternalizeString.html
===================================================================
--- branches/work_Ed/org.maemo.esbox.help/html/tasks/ExternalizeString.html	2009-05-27 02:43:26 UTC (rev 1650)
+++ branches/work_Ed/org.maemo.esbox.help/html/tasks/ExternalizeString.html	2009-05-27 14:10:50 UTC (rev 1651)
@@ -1,48 +1,134 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html lang="en">
 <head>
 	<meta name="copyright" content="Copyright (c) INdT 2007-2009, (c) Nokia 2008-2009. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
 	<meta http-equiv="Content-Language" content="en-us">
 	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-	<title>Externalize string on C/C++ application</title>
+	
+	<title>Externalize Strings</title>
+	
 	<link rel="stylesheet" type="text/css" href="../help.css">
+    
     <style type="text/css">
-<!--
-.style1 {font-weight: bold}
--->
+	<!--
+
+		.title {
+			font-weight: bold
+		}
+		
+		.separate {
+ 			margin-bottom: 3em;
+		}
+			
+	-->
     </style>
 </head>
 
 <body>
-<h2 class="style1">Extracting Strings</h2>
 
+<h2 class="title">
+	Extracting Strings
+</h2>
 
-<p>The Externalize Strings wizard allows you to refactor a compilation unit 
-such that strings used in the compilation unit can be translated to different languages using
-the GNU gettext mechanism.</p>
-<p>To externalize strings:</p>
-  <ol>
-	<li>Select a project in Project Explorer and right-click to display the popup menu and select <strong>Source &gt; Externalize Strings</strong>.
-	<p/><img src="../images/extractstrings.png" alt="Externalize String" width="430" height="459"></p>
+<p>
+	The Externalize Strings wizard allows you to refactor a compilation unit 
+	such that strings used in the compilation unit can be translated to different
+	languages using	the GNU gettext mechanism. The wizard supports C/C++ and
+	Python projects. 
+</p>
+
+<p>
+	To externalize strings:
+</p>
+
+<ol>
+	<li class="separate">
+		<p>	
+			Select a project in Project Explorer and right-click project root to display 
+			the popup menu and select <strong>Source &gt; Externalize Strings</strong>.	
+		<p/>
+		
+		<img src="../images/externalize/es-menu.png" alt="Externalize String">
 	</li>
-    <li>Select the file(s) that should be externalized to enable the Externalize button, then click Externalize.
-	<p/><img src="../images/extractstrings1.png" alt="File that should be externalized" width="400" height="500"></p>
+	
+    <li class="separate">
+    	<p>
+    		Select the file(s) that should be externalized to enable the Externalize 
+    		button, then click Externalize.
+		<p/>
+		
+		<img src="../images/externalize/es-select.png"
+		     alt="File that should be externalized">
 	</li>
-    <li>A Wizard will appear showing strings that will be externalized. You can define the name of the output file, msgstr, and msgid. Click on a message string or message id to make a change.
-	<p/><img src="../images/extractstrings2.png" alt="Externalize Wizard" width="719" height="726"></p>
+	
+    <li class="separate">
+    	<p>
+    		A Wizard will appear showing strings that will be externalized. You can
+    		define the name of the output file and msgstr (translation). Click on a
+    		message string to make a change. Insert missing definitions option checks
+    		source code for missing headers and insert those if needed.
+		</p>
+		<p>
+			There is three actions for each string. 
+			<ul style="list-style-type:none">
+				<li>
+					<img src="../images/externalize/translate.gif" alt="Translate button">
+					<em>Externalize</em>: 
+					Translate string.
+				</li>
+				
+				<li>
+					<img src="../images/externalize/never_translate.gif"
+					     alt="Never translate button">
+					<em>Internalize</em>:
+					Do not translate the string and do not include string next time. 
+				</li>
+				
+				<li>
+					<img src="../images/externalize/skip.gif" alt="Skip button">
+					<em>Skip</em>:
+					Do not change the string.
+				</li>
+			</ul>
+		</p>
+
+		<img src="../images/externalize/es-translate.png" alt="Externalize Wizard">
 	</li>
-	<li>Click Finish.
+	
+	<li class="separate">
+		<p>
+			Next page shows translation changes. Cancel discard changes and finish
+			applies changes into selected files.
+		</p>
+		
+		<img src="../images/externalize/es-view.png" alt="Externalize Wizard">
 	</li>
+	
+	<li class="separate">
+		<p>
+			Click Finish.
+		</p>
+	</li>
 </ol>
 
-<p>A couple of files will be generated (<tt>POTFILE.in</tt> and <tt>outputName.po</tt>) which will be placed in 
-the <strong><em>ProjectName</em>/po/</strong> directory.</p>
+<p>
+	This generates or updates translation file <tt><em>outputName</em>.po</tt> and
+	files for Automake (<tt>POTFILE.in</tt>, and <tt>LINGUAS</tt>) which will be
+	placed in the <strong><em>ProjectName</em>/po/</strong> directory.
+</p>
+
 <ul>
- <li><tt>POTFILES.in</tt> contains the list of source code files that will be localized.</li> 
- <li> <tt>outputName</tt>.po includes translated text.</li>
+	<li>
+		<tt>POTFILES.in</tt> contains the list of source code files that will be localized.
+	</li>
+	<li>
+		<tt><em>outputName</em>.po</tt> includes translated text.
+	</li>
+	<li>
+		<tt>LINGUAS</tt> contains the list of languages that will be generated.
+	</li>
 </ul>
 
-<p>The Console view will output any warnings and errors.</p>
-
 </body>
 </html>
+



More information about the Esbox-commits mailing list