android_calculator-5: App help

2011-11-19 16:06:24 +04:00
parent 3e051a0214
commit e7e7d7aca5
24 changed files with 536 additions and 24 deletions
--- a/res/layout/about.xml
+++ b/res/layout/about.xml
@@ -21,7 +21,7 @@

 	<TextView
 			a:id="@+id/aboutTextView"
-			a:text="@string/c_copyright"
+			a:text="@string/c_about_content"
 			a:layout_height="fill_parent"
 			a:layout_width="fill_parent"
 			a:layout_gravity="top|center_horizontal"
--- a/res/layout/calc_five_digit_button.xml
+++ b/res/layout/calc_five_digit_button.xml
@@ -9,7 +9,7 @@
 													   xmlns:calc="http://schemas.android.com/apk/res/org.solovyev.android.calculator"
 													   a:id="@+id/fiveDigitButton"
 													   a:text="5"
-													   calc:textUp="cosh"
-													   calc:textDown="acosh"
+													   calc:textUp="t"
+													   calc:textDown="j"
 													   style="?digitButtonStyle"
 													   a:onClick="digitButtonClickHandler"/>
--- a/res/layout/calc_four_digit_button.xml
+++ b/res/layout/calc_four_digit_button.xml
@@ -9,7 +9,7 @@
 													   xmlns:calc="http://schemas.android.com/apk/res/org.solovyev.android.calculator"
 													   a:id="@+id/fourDigitButton"
 													   a:text="4"
-													   calc:textUp="sinh"
-													   calc:textDown="asinh"
+													   calc:textUp="x"
+													   calc:textDown="y"
 													   style="?digitButtonStyle"
 													   a:onClick="digitButtonClickHandler"/>
--- a/res/layout/help.xml
+++ b/res/layout/help.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+  ~ Copyright (c) 2009-2011. Created by serso aka se.solovyev.
+  ~ For more information, please, contact se.solovyev@gmail.com
+  ~ or visit http://se.solovyev.org
+  -->
+
+<TabHost xmlns:a="http://schemas.android.com/apk/res/android"
+		 a:id="@android:id/tabhost"
+		 a:layout_width="fill_parent"
+		 a:layout_height="fill_parent">
+
+	<LinearLayout
+			a:orientation="vertical"
+			a:layout_width="fill_parent"
+			a:layout_height="fill_parent">
+
+		<TabWidget
+				a:id="@android:id/tabs"
+				a:layout_width="fill_parent"
+				a:layout_height="wrap_content"/>
+
+		<FrameLayout
+				a:id="@android:id/tabcontent"
+				a:layout_width="fill_parent"
+				a:layout_height="fill_parent"/>
+
+	</LinearLayout>
+</TabHost>
--- a/res/layout/help_faq.xml
+++ b/res/layout/help_faq.xml
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+  ~ Copyright (c) 2009-2011. Created by serso aka se.solovyev.
+  ~ For more information, please, contact se.solovyev@gmail.com
+  ~ or visit http://se.solovyev.org
+  -->
+
+
+<ScrollView xmlns:a="http://schemas.android.com/apk/res/android"
+			a:layout_width="fill_parent"
+			a:layout_height="fill_parent">
+
+	<TextView
+			a:text="@string/c_faq_content"
+			a:layout_width="fill_parent"
+			a:layout_height="fill_parent"
+			a:gravity="top|left"
+			a:layout_weight="1"
+			a:scrollbars="vertical"
+			style="@style/about_style"/>
+
+</ScrollView>
+
--- a/res/layout/help_hints.xml
+++ b/res/layout/help_hints.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+  ~ Copyright (c) 2009-2011. Created by serso aka se.solovyev.
+  ~ For more information, please, contact se.solovyev@gmail.com
+  ~ or visit http://se.solovyev.org
+  -->
+<ScrollView xmlns:a="http://schemas.android.com/apk/res/android"
+			a:layout_width="fill_parent"
+			a:layout_height="fill_parent">
+
+	<TextView
+			xmlns:a="http://schemas.android.com/apk/res/android"
+			a:text="@string/c_hints_content"
+			a:gravity="top|left"
+			a:layout_weight="1"
+			a:scrollbars="vertical"
+			style="@style/about_style"/>
+
+</ScrollView>
--- a/res/layout/help_screens.xml
+++ b/res/layout/help_screens.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+  ~ Copyright (c) 2009-2011. Created by serso aka se.solovyev.
+  ~ For more information, please, contact se.solovyev@gmail.com
+  ~ or visit http://se.solovyev.org
+  -->
+<ScrollView xmlns:a="http://schemas.android.com/apk/res/android"
+			a:layout_width="fill_parent"
+			a:layout_height="fill_parent">
+
+	<TextView
+			xmlns:a="http://schemas.android.com/apk/res/android"
+			a:text="@string/c_screens_content"
+			a:gravity="top|left"
+			a:layout_weight="1"
+			a:scrollbars="vertical"
+			style="@style/about_style"/>
+
+</ScrollView>
--- a/res/menu/main_menu.xml
+++ b/res/menu/main_menu.xml
@@ -8,6 +8,9 @@
 	<item a:id="@+id/main_menu_item_history"
 		  a:title="@string/c_history"/>

+	<item a:id="@+id/main_menu_item_help"
+		  a:title="@string/c_help"/>
+
 	<item a:id="@+id/main_menu_item_about"
 		  a:title="@string/c_about"/>

--- a/res/values-ru/strings.xml
+++ b/res/values-ru/strings.xml
@@ -22,7 +22,7 @@
 	<string name="c_restart">Перезапуск</string>

 	<!--ABOUT ACTIVITY-->
-	<string name="c_copyright">Copyright (c) 2009-2011\n\n<b>Программа создана\nserso aka se.solovyev</b>\n\n
+	<string name="c_about_content">Copyright (c) 2009-2011\n\n<b>Программа создана\nserso aka se.solovyev</b>\n\n
 		Эта программа с открытыми исходным кодом:\nон может быть найден на \n<a href="https://github.com/serso/android_calculator">http://github.com</a>\n\n
 		За подробной информацией, пожалуйста,\nобращайтесь на почту\n<a href="mailto:se.solovyev@gmail.com">se.solovyev@gmail.com</a>\n
 		или посетите сайт \n<a href="http://se.solovyev.org">http://se.solovyev.org</a>\n\n
@@ -154,4 +154,100 @@
 	<string name="c_op_description_integral">Возвращает интеграл функции \'f(x)\' по переменно \'x\'.</string>
 	<string name="c_op_description_integral_ab">Интегрирует функцию \'f(x)\' по переменной \'x\' от \'a\' до \'b\'.</string>

+	<string name="c_pf_description_factorial">Возвращает факториал от предыдущего выражения.</string>
+	<string name="c_pf_description_percent" formatted="false">Возвращает процентное значение от предыдущего выражения.\nПримеры:\n
+		100 + 50% = 150\n
+		100 * 50% = 50\n
+		100 + 100 * 50% * 50% = 125
+	</string>
+	<string name="c_pf_description_degree">Преобразует градусы в радианы.\n
+		Примеры:\n
+		268° = 4.67748\n
+		30.21° = 0.52726
+	</string>
+
+	<string name="c_faq">FAQ</string>
+	<string name="c_hints">Подсказки</string>
+	<string name="c_screens">Экраны</string>
+
+	<string name="c_faq_content" formatted="false">
+<b>Как я могу использовать функции написанные в верхнем правом и нижнем правом углах кнопки?</b>\n
+\n
+Нажмите на кнопку и потяните вверх или вниз. В зависимости от значения указанного на кнопке произойдёт действие.\n
+\n
+<b>Как я могу переключиться между радианами и градусами?</b>\n
+\n
+На данный момент К++ не поддерживает такого переключения, но вы можете использовать функции deg() и rad() или опертор ° для переода радиан в градусы и наоборот.\n
+\n
+<b>Примеры:</b>\n
+268° = 4.67748\n
+30.21° = 0.52726\n
+rad(30, 21, 0) = 0.52726\n
+deg(4.67748) = 268\n
+\n
+<b>Поддерживает ли К++ проценты?</b>\n
+\n
+Да, функция % может быть найдена в правом верхнем углу кнопки /.\n
+\n
+<b>Примеры:</b>\n
+\n
+100 + 50% = 150\n
+100 * 50% = 50\n
+100 + 100 * 50% * 50% = 125\n
+100 + (100 * 50% * (25 + 25)% + 100%) = 150\n
+\n
+<b>Замечание:</b>\n
+\n
+100 + (20 + 20)% = 140, <b>но</b> 100+  (20% + 20%) = 124.0\n
+100 + 50% ^ 2 = 2600, <b>но</b> 100 + 50 ^ 2% = 101.08\n
+\n
+<b>Поддерживает ли К++ дробные вычисления?</b>\n
+\n
+Да, вы можете ввести дробное выражение в редактор и нажать ≡ (в правом верхнем углу кнопки =). Также вы можете использовать ≡ для упрощения выражений.\n
+\n
+<b>Примеры:</b>\n
+\n
+2/3 + 5/9 ≡ 11/9\n
+2/9 + 3/123 ≡ 91/369\n
+(6 - t) ^ 3 ≡ 216 - 108t + 18t ^ 2 - t ^ 3\n
+\n
+<b>Поддерживает ли К++ комплексные вычисления?</b>\n
+\n
+Да, просто введите комплексное выражение (используя i или √(-1) в качестве мнимого числа).\n
+\n
+<b>Примеры:</b>\n
+\n
+(2i + 1) ^ = -3 + 4i\n
+e ^ i = 0.5403 + 0.84147i\n
+\n
+<b>Умеет ли К++ рисовать графики функций?</b>\n
+\n
+Нет.\n
+\n
+<b>Поддерживает ли К++ матричные вычисления?</b>\n
+\n
+Нет.\n
+\n
+<b>Почему я получаю 1.76732452452345E-17 вместо 0?</b>\n
+\n
+Проверьте опцию \'Округление результата\' в настройках приложения - она должно быть включена.\n
+	</string>
+
+		<string name="c_hints_content">
+			1. Вы можете опускать ненужные знаки произведения в выражении (вместо 3*t или t*sin(π*t) просто пишите 3t или tsin(πt)).\n\n
+2. Используйте ≡ (в верхнем правом углу кнопки =) для упрощения выражения.\n\n
+3. Нажмите на результат для того, чтобы скопировать его в буфер обмена.\n\n
+4. Используйте кнопку = реже - результат вычисляется на лету.\n\n
+4. Создайте константы для часто используемых значений (таким образом вы можете даже сохранять выражения)
+	</string>
+
+	<string name="c_screens_content">
+		1. <b>Основной экран:</b> открывается по старту приложения, на него можно попасть из любого другого экрана нажав кнопку Назад.\n\n
+2. <b>Экран констант и переменных:</b> содержит список переменных и констант. Пользователь может добавить новые элементы нажав кнопку Добавить. Короткое нажатие вставляет значение в редактор, длинное - открывает окно редактирования. На экран можно попасть нажав кнопку π,… на основном экране.\n\n
+3. <b>Экран функций:</b> содержит список всех доступных функций. Короткое нажатие вставляет функцию в редактор. На экран можно попасть нажав кнопку f(x) на основном экране.\n\n
+4. <b>Экран операторов:</b> содержит список всех доступных операторов. Короткое нажатие вставляет оператор в редактор. На экран можно попасть нажав кнопку ∂,… на основном экране.\n\n
+5. <b>Экран истории:</b> содержит список всех операций произведённых пользователем.  Короткое нажатие на элемент списка вставляет его в редактор. На экран можно попасть нажав кнопку M на основном экране.\n\n
+6. <b>Экран настроек:</b> содержит список настроек приложения. На экран можно попасть нажав кнопку Настройки в меню.
+			</string>
+
 </resources>
--- a/res/values/strings.xml
+++ b/res/values/strings.xml
@@ -23,7 +23,7 @@
 	<string name="c_restart">Restart</string>

 	<!--ABOUT ACTIVITY-->
-	<string name="c_copyright">Copyright (c) 2009-2011\n\n<b>Created by serso aka se.solovyev</b>\n\n
+	<string name="c_about_content">Copyright (c) 2009-2011\n\n<b>Created by serso aka se.solovyev</b>\n\n
 		This program is open source:\nall source code can be found on\n<a href="https://github.com/serso/android_calculator">http://github.com</a>\n\n
 		For more information please\ncontact the author by email\n<a href="mailto:se.solovyev@gmail.com">se.solovyev@gmail.com</a>
 		\nor visit\n<a href="http://se.solovyev.org">http://se.solovyev.org</a>\n\n
@@ -155,5 +155,102 @@
 	<string name="c_op_description_integral">Gives integral of function \'f(x)\' by \'x\' variable.</string>
 	<string name="c_op_description_integral_ab">Integrates function \'f(x)\' by \'x\' variable from \'a\' to \'b\'.</string>

+	<string name="c_pf_description_factorial">Gives the factorial for expression before.</string>
+	<string name="c_pf_description_percent" formatted="false">Gives the percent value for expression
+		before.\nExamples:\n
+		100 + 50% = 150\n
+		100 * 50% = 50\n
+		100 + 100 * 50% * 50% = 125
+	</string>
+	<string name="c_pf_description_degree">Converts degrees to radians.\n
+		Examples:\n
+		268° = 4.67748\n
+		30.21° = 0.52726
+	</string>
+
+	<string name="c_faq">FAQ</string>
+	<string name="c_hints">Hints</string>
+	<string name="c_screens">Screens</string>
+
+	<string name="c_faq_content" formatted="false">
+<b>How can I use functions written in the top right and bottom right corners of the button?</b>\n
+\n
+Push the button and slide lightly up or down. Depending on value showed on the button action will occur.\n
+\n
+<b>How can I toggle between radians and degrees?</b>\n
+\n
+Currently C++ doesn\'t support this feature but you can use deg() and rad() functions and ° operator to convert degrees to radians and vice versa.\n
+\n
+<b>Examples:</b>\n
+268° = 4.67748\n
+30.21° = 0.52726\n
+rad(30, 21, 0) = 0.52726\n
+deg(4.67748) = 268\n
+\n
+<b>Does C++ support %?</b>\n
+\n
+Yes, % function can be found in the top right corner of / button.\n
+\n
+<b>Examples:</b>\n
+\n
+100 + 50% = 150\n
+100 * 50% = 50\n
+100 + 100 * 50% * 50% = 125\n
+100 + (100 * 50% * (25 + 25)% + 100%) = 150\n
+\n
+<b>Note:</b>\n
+\n
+100 + (20 + 20)% = 140, <b>but</b> 100+  (20% + 20%) = 124.0\n
+100 + 50% ^ 2 = 2600, <b>but</b> 100 + 50 ^ 2% = 101.08\n
+\n
+<b>Does C++ support fractional calculations?</b>\n
+\n
+Yes, you can type your fractional expression in the editor and use ≡ (in the top right corner of = button). Also you can use ≡ to simplify expression.\n
+\n
+<b>Examples:</b>\n
+\n
+2/3 + 5/9 ≡ 11/9\n
+2/9 + 3/123 ≡ 91/369\n
+(6 - t) ^ 3 ≡ 216 - 108t + 18t ^ 2 - t ^ 3\n
+\n
+<b>Does C++ support complex calculations?</b>\n
+\n
+Yes, just enter complex expression (using i or √(-1) as imaginary number).\n
+\n
+<b>Examples:</b>\n
+\n
+(2i + 1) ^ = -3 + 4i\n
+e ^ i = 0.5403 + 0.84147i\n
+\n
+<b>Can C++ plot graph of the function?</b>\n
+\n
+No, currently C++ cannot plot functions\' graphs.\n
+\n
+<b>Does C++ support matrix calculations?</b>\n
+\n
+No, it doesn\'t.\n
+\n
+<b>Why I\'ve got 1.76732452452345E-17 instead of 0?</b>\n
+\n
+Check the \'Round result\' preference in application settings - it should be turned on.\n</string>
+
+	<string name="c_hints_content">
+	1. You can omit unnecessary multiplication signs (instead of 3*t or t*sin(π*t) just type 3t or tsin(πt))\n\n
+2. Use ≡ (in the top right corner of = button) to simplify expression\n\n
+3. Just click on the result to copy it to the clipboard\n\n
+4. Use = button seldom - result is calculating on the fly\n\n
+4. Add constants for often used values (you can even save expressions)\n\n
+	</string>
+
+	<string name="c_screens_content">
+		1. <b>Main screen:</b> is shown on application start, can be reached from another screen by pressing Back button.\n\n
+2. <b>Variables and Constants screen:</b> contains list of available constants. User may add some constants and variables here by clicking Add button. Short click on variable/constant inserts it into the editor, long click - opens variable editor window. Can be reached from the main screen by pressing π,… button.\n\n
+3. <b>Functions screen:</b> contains list of all available functions. Short click on function inserts it into the editor. Can be reached from the main screen by pressing f(x) button.\n\n
+4. <b>Operators screen:</b> contains list of all available operators. Short click on operator inserts it into the editor. Can be reached from the main screen by pressing ∂,… button.\n\n
+5. <b>History screen:</b> contains list of all actions done by user.  Short click on history item sets it into the editor. Can be reached from the main screen by pressing M button.\n\n
+6. <b>Settings screen:</b> contains application preferences. Can be reached from the main screen by pressing Settings in menu.
+			</string>
+
+

 </resources>