<html>
<head>
<meta content="text/html; charset=ISO-8859-1"
http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
Dear Darius<br>
<br>
Am 11.06.13 13:22, schrieb Darius Miliauskas:
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div>Dear Michael,<br>
</div>
<div><br>
</div>
<div>Thank you for your feedback! According your answer, some
questions I need to explain more.</div>
<div><br>
</div>
<div>1) Yes, I followed the instructions which is on <a
moz-do-not-send="true"
href="http://www.yanel.org/download/source-repository.html"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">http://www.yanel.org/download/source-repository.html</a> and <a
moz-do-not-send="true"
href="https://help.github.com/articles/set-up-git"
target="_blank">https://help.github.com/articles/set-up-git</a></div>
<div>To be more precise, instead I installed GitHub just added
Yanel on my PC.</div>
<div>To make more convenient navigation, you can add the link
from <a moz-do-not-send="true"
href="http://www.yanel.org/download/source-repository.html"
target="_blank">http://www.yanel.org/download/source-repository.html</a></div>
<div>to <a moz-do-not-send="true"
href="http://www.yanel.org/en/getting-started/unix.html"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">http://www.yanel.org/en/getting-started/unix.html</a> and <a
moz-do-not-send="true"
href="http://www.yanel.org/en/getting-started/windows.html"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">http://www.yanel.org/en/getting-started/windows.html</a><font
face="arial, sans-serif">.</font></div>
</div>
</blockquote>
<br>
I am still not sure I understand, because these pages already
cross-link each other.<br>
Can you send a patch of the XHTML in order to show what changes you
would made?<br>
<br>
The XHTML of the Yanel documentation/website can be found at<br>
<br>
YANEL_SOURCE/src/realms/yanel-website/data-repo/data/<br>
<br>
hence for example <a moz-do-not-send="true"
href="http://www.yanel.org/download/source-repository.html"
target="_blank">http://www.yanel.org/download/source-repository.html</a>
corresponds with<br>
<br>
<br>
YANEL_SOURCE/src/realms/yanel-website/data-repo/data/download/source-repository.html<br>
<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div><font face="arial, sans-serif"><br>
</font></div>
<div><font face="arial, sans-serif">2) I would add in the
README.txt file. I would change, for example,</font></div>
<div><font face="arial, sans-serif"><br>
</font></div>
<div>
<div>"2) Start Yanel by running</div>
<div><br>
</div>
<div> UNIX: ./yanel.sh start</div>
<div> Windows: yanel.bat start"</div>
<div><br>
</div>
<div>to </div>
<div><br>
</div>
<div>
<div>"2) Start Yanel by running</div>
<div><br>
</div>
<div> UNIX (Linux and Mac OS): ./yanel.sh start</div>
<div> Windows: yanel.bat start"</div>
<div><br>
</div>
<div>The same in the lines:</div>
<div><br>
</div>
<div>
<div> "1) Build Yanel by running</div>
<div><br>
</div>
<div> UNIX: ./build.sh quick-start</div>
<div> Windows: build.bat quick-start"</div>
<div><br>
</div>
<div>Did you get me?</div>
</div>
</div>
</div>
</div>
</blockquote>
<br>
yes, I have changed it now and already pushed to github (please do a
"git pull")<br>
<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div>
<div>
<div>
</div>
</div>
</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">3) Yanel was not correctly installed,
therefore, I couldn't start and run it. The last sentence just
describe the practical pattern which the user experiences. He
open my browser ("Safari"), type "<a moz-do-not-send="true"
href="http://127.0.0.1:8080/yanel/" target="_blank">http://127.0.0.1:8080/yanel/</a>"
in the address bar, and got the certain message on his
browser. I add the screen shot as the attachment to explain
what I meant.</div>
</div>
</blockquote>
<br>
but from the screenshot it seems like you didn't enter the port 8080
and the yanel prefix<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">Which improvement to describe in <a
moz-do-not-send="true"
href="https://github.com/wyona/yanel/issues"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">https://github.com/wyona/yanel/issues</a>?
Do you mean the one with the message in the browser or the one
when I mistyped "./build.sh quick-start"? Or the one that
"quick-start" does not precisely carries the meaning of
installing Yanel?</div>
</div>
</blockquote>
<br>
that if someone is typing build.sh or yanel.sh without any
arguments, that then these shell scripts will tell you which
arguments are possible and what they are used for<br>
<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">4) I was talking about some help for
the user during he types in Terminal.</div>
<div class="gmail_extra">For example, type <i>./build.sh /?</i></div>
<div class="gmail_extra">and get</div>
<div class="gmail_extra"><i>clean-all Clean a previous build<br>
</i></div>
<div class="gmail_extra"><i>quick-start Build Yanel by
running<br>
</i></div>
<div class="gmail_extra">
<i>start Start Yanel by running</i></div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">or type <i>./build.sh </i>help</div>
<div class="gmail_extra">and get that</div>
<div class="gmail_extra">
<br>
</div>
<div class="gmail_extra">Yanel is a great tool bla bla</div>
<div class="gmail_extra">The most commonly used Yanel commands
are: </div>
<div class="gmail_extra">
<div class="gmail_extra"><i>clean-all Clean a previous
build<br>
</i></div>
<div class="gmail_extra"><i>quick-start Build Yanel by
running<br>
</i></div>
<div class="gmail_extra"><i>start Start Yanel by running</i></div>
</div>
</div>
</blockquote>
<br>
<br>
this improvement you should add to<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/wyona/yanel/issues"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">https://github.com/wyona/yanel/issues</a><br>
<br>
also see 3)<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_extra"><i><br>
</i></div>
<div class="gmail_extra">
5) You can use "yanel" command as, for example, "git"
instead of typing "<i>./build.sh</i>". I do not know whether
such replacement is possible, and how to make it. Do you
get?</div>
</div>
</div>
</blockquote>
<br>
no, I don't understand. Do you mean that there is only one shell
script called yanel.sh instead build.sh and yanel.sh ?<br>
<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div class="gmail_extra">
<div class="gmail_extra">
<br>
</div>
<div class="gmail_extra">The last lines (4) and 5)) was just
suggestions for a possible improvement. <br>
</div>
</div>
</div>
</blockquote>
<br>
that's why you should add them as enhancements to<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/wyona/yanel/issues"
style="font-family:arial,sans-serif;font-size:13px"
target="_blank">https://github.com/wyona/yanel/issues</a><br>
<br>
Thanks<br>
<br>
Michael<br>
<blockquote
cite="mid:CAM6O59cYcwjv-6KLi7z1M7vgDKHKbgzzJOmTwwpyut5L=cHfvw@mail.gmail.com"
type="cite">
<div dir="ltr">
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">
Best Wishes,</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">Darius</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra"><br>
</div>
<div class="gmail_extra">
<br>
</div>
<div class="gmail_extra">
<div class="gmail_quote">2013/6/5 Michael Wechner <span
dir="ltr"><<a moz-do-not-send="true"
href="mailto:michael.wechner@wyona.com" target="_blank">michael.wechner@wyona.com</a>></span><br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px
0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div bgcolor="#FFFFFF" text="#000000"> Dear Darius<br>
<br>
Thanks very much for your feedback. Please find my
comments/questions inline below<br>
<br>
Am 04.06.13 22:34, schrieb Darius Miliauskas:
<div>
<blockquote type="cite">
<div dir="ltr">Dear All,
<div><br>
</div>
<div>I have some questions/suggestions regarding
the experience which I had trying to install
Yanel on the PC (Apple MacBook). The PC runs Mac
OS X (Version 10.7.5). The important suggestions
were marked as bold, not to make you lost in
such a long text.</div>
<div><br>
</div>
<div>1) I downloaded/installed GitHub (<a
moz-do-not-send="true"
href="https://help.github.com/articles/set-up-git"
target="_blank">https://help.github.com/articles/set-up-git</a>),
before I was required to create my account
there.</div>
<div>First of all, I needed to open Terminal.<br>
</div>
<div>I made a directory with the command: mkdir
src;</div>
<div>Then I put the following line: git clone <a
moz-do-not-send="true"
href="https://github.com/wyona/yanel.git"
target="_blank">https://github.com/wyona/yanel.git</a></div>
<div>However, I got an error:</div>
<div><br>
</div>
<div><i>-bash: git:command not found</i></div>
<div><i><br>
</i>That was the first serious issue I met. <b>The
same issue the other users found with Mac OS X
(Lion) system</b>: <a moz-do-not-send="true"
href="http://www.hongkiat.com/blog/mountain-lion-git-fix/"
target="_blank">http://www.hongkiat.com/blog/mountain-lion-git-fix/</a>.<br>
In order to solve the issue, I needed to find on
AppleStore and install Xcode. It is a gratis
software used to code the applications for MAC.<br>
After the installation I needed to install he
Command Line Tool via the preferences of Xcode.</div>
<div>Finally, it worked.</div>
<div>2) I followed the instructions,</div>
</div>
</blockquote>
<br>
</div>
which instructions exactly did you follow? Was it<br>
<br>
<a moz-do-not-send="true"
href="http://www.yanel.org/download/source-repository.html"
target="_blank">http://www.yanel.org/download/source-repository.html</a><br>
<br>
?
<div><br>
<blockquote type="cite">
<div dir="ltr">
<div> and put Yanel on my PC. However, I was not
sure how to build and run it. I open README.txt
file in the directory Yanel (command line: open
README.txt)</div>
</div>
</blockquote>
<br>
</div>
do you think we should add a link/note to<br>
<br>
<a moz-do-not-send="true"
href="http://www.yanel.org/download/source-repository.html"
target="_blank">http://www.yanel.org/download/source-repository.html</a><br>
<br>
pointing to<br>
<br>
<a moz-do-not-send="true"
href="http://www.yanel.org/en/getting-started/unix.html"
target="_blank">http://www.yanel.org/en/getting-started/unix.html</a><br>
(or <a moz-do-not-send="true"
href="http://www.yanel.org/en/getting-started/windows.html"
target="_blank">http://www.yanel.org/en/getting-started/windows.html</a>)
<div><br>
<br>
?<br>
<br>
<blockquote type="cite">
<div dir="ltr">
<div>a) the command "quick-start" is used to build
Yanel on the PC, not just start Yanel.</div>
<div>So, it is definitely required to build the
code before to run Yanel on your PC.</div>
<div>b) <i
style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">Mac</i><span
style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px"> OS
X, is a series of </span><i
style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">Unix</i><span
style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">-</span><i
style="font-weight:bold;font-style:normal;color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px">based</i><span
style="color:rgb(68,68,68);font-family:arial,sans-serif;line-height:16px"> graphical
interface operating systems. Not everybody
knows it. In the README.txt <b>I will add a
line like *for Mac OS X use UNIX.</b></span></div>
</div>
</blockquote>
<br>
</div>
where exactly would you add this line?<br>
Can you send a patch?
<div><br>
<br>
<blockquote type="cite">
<div dir="ltr">
<div><font face="arial, sans-serif"
color="#444444"><span style="line-height:16px">3)
The process of build&run was the
following:</span></font></div>
<div><font face="arial, sans-serif"
color="#444444"><span style="line-height:16px">make
sure you are on the directory of Yanel, for
example, in my case: </span></font></div>
<div><font face="arial, sans-serif"
color="#444444"><span style="line-height:16px"><br>
</span></font></div>
<div><i>new-host:yanel kristinaslekyte$</i></div>
<div><br>
</div>
<div>kristinaslekyte is a name for the PC (the
owner is Kristina Slekyte).</div>
<div><br>
</div>
<div>so, it should be:</div>
<div> </div>
<div><i>new-host:yanel YourPC$</i><br>
</div>
<div><br>
</div>
<div>so I put the following commands:</div>
<div><br>
</div>
<div>
<div><i>export
JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home</i></div>
<div><i>echo $JAVA_HOME</i></div>
<div><i>./build.sh quick-start</i><br>
</div>
<div><br>
</div>
<div>the line with export is required to avoid
"ERROR: No JAVA_HOME set!"</div>
<div>echo just justify that the command export
worked out.</div>
<div>In the case you want to terminate processes
in Terminal, click "control+C".</div>
<div>In order to build it is important to put
"./build.sh quick-start" without any mistypes,
otherwise, even the build successful you will
get the following error when you run Yanel:</div>
<div><br>
</div>
<div>
<div><i>BUILD FAILED</i></div>
<div><i>/Users/kristinaslekyte/src/yanel/src/build/targets/cruise-control/continuous-integration.xml:25:
The following error occurred while
executing this line:</i></div>
<div><i>/Users/kristinaslekyte/src/yanel/src/build/targets/cruise-control/continuous-integration.xml:59:
No Tomcat is set inside
local.build.properties! Please note that
if you build Yanel from scratch, then you
should use the 'quick-start' target (<a
moz-do-not-send="true"
href="https://github.com/wyona/yanel"
target="_blank">https://github.com/wyona/yanel</a>).</i></div>
<div><br>
</div>
<div>So, finally, I built it, and I could run
with the line:</div>
<div><br>
</div>
<div><i>./yanel.sh start</i><br>
</div>
<div><br>
</div>
<div>Then open my browser ("Safari"), and I
put "<a moz-do-not-send="true"
href="http://127.0.0.1:8080/yanel/"
target="_blank">http://127.0.0.1:8080/yanel/</a>"
in the address bar. I got the page instead
the message that the page cannot be opened.</div>
</div>
</div>
</div>
</blockquote>
<br>
</div>
Can you explain your last setence here what you mean
exactly?
<div>
<div><br>
<blockquote type="cite">
<div dir="ltr">
<div>
<div>
<div><br>
</div>
<div>BRAVO, Yanel is running on my PC.</div>
<div><br>
</div>
<div>4) <b>Actually, it would be nice to
get know what commands I can use with
Yanel in terminal, like</b></div>
<div> <br>
</div>
<div><i>./yanel.sh ?</i><br>
</div>
<div><br>
</div>
<div>? stands for "start".</div>
<div><br>
</div>
<div>Perhaps, I can put just yanel, and get
the lines what I can do like I got when I
typed "git":</div>
<div><br>
</div>
<div>
<div><i>The most commonly used git
commands are:</i></div>
<div><i> add Add file contents to
the index</i></div>
<div><i> bisect Find by binary
search the change that introduced a
bug</i></div>
<div><i> branch List, create, or
delete branches</i></div>
<div><i> checkout Checkout a branch or
paths to the working tree</i></div>
<div><i> clone Clone a repository
into a new directory</i></div>
<div><i> commit Record changes to
the repository</i></div>
<div><i> diff Show changes between
commits, commit and working tree, etc</i></div>
<div><i> fetch Download objects and
refs from another repository</i></div>
<div><i> grep Print lines matching
a pattern</i></div>
<div><i> init Create an empty git
repository or reinitialize an existing
one</i></div>
<div><i> log Show commit logs</i></div>
<div><i> merge Join two or more
development histories together</i></div>
<div><i> mv Move or rename a
file, a directory, or a symlink</i></div>
<div><i> pull Fetch from and merge
with another repository or a local
branch</i></div>
<div><i> push Update remote refs
along with associated objects</i></div>
<div><i> rebase Forward-port local
commits to the updated upstream head</i></div>
<div><i> reset Reset current HEAD
to the specified state</i></div>
<div><i> rm Remove files from
the working tree and from the index</i></div>
<div><i> show Show various types
of objects</i></div>
<div><i> status Show the working
tree status</i></div>
<div><i> tag Create, list, delete
or verify a tag object signed with GPG</i></div>
</div>
</div>
</div>
</div>
</blockquote>
<br>
</div>
</div>
yes, I think that would be nice.<br>
<br>
Can you open an issue on github and describe this
improvement:<br>
<br>
<a moz-do-not-send="true"
href="https://github.com/wyona/yanel/issues"
target="_blank">https://github.com/wyona/yanel/issues</a>
<div><br>
<blockquote type="cite">
<div dir="ltr">
<div>
<div>
<div> <br>
</div>
<div><b>Secondly, the user would enjoy if he
can just get help immediately in Terminal,
and put question mark to get the lines
with the suggestions what to use further.</b></div>
</div>
</div>
</div>
</blockquote>
<br>
</div>
I am not sure I understand, can you make an example?
<div><br>
<br>
<blockquote type="cite">
<div dir="ltr">
<div>
<div>
<div>Thirdly, is it possible just to type like
yanel build or yanel start?</div>
</div>
</div>
</div>
</blockquote>
<br>
</div>
I am not sure I understand this either. Can you also
explain a bit more?
<div><br>
<blockquote type="cite">
<div dir="ltr">
<div>
<div>
<div><br>
</div>
<div>I learnt a lot while I installed Yanel on
the PC.</div>
<div><br>
</div>
<div> </div>
<div>All the Best,</div>
<div><br>
</div>
<div>Darius Miliauskas</div>
<div> Lithuania</div>
<div><br>
</div>
<div>p. s. I am thankful for my girlfriend
Kristina Slekyte (her Apple I used), and for
Michael Wechner (Wyona), his assistance was
tremendous while I went through the issues.</div>
</div>
</div>
</div>
</blockquote>
<br>
</div>
Thank you very much for sharing your experiences. I
think it helps us a lot to improve Yanel.<br>
<br>
Best wishes<br>
<br>
Michael<br>
<blockquote type="cite">
<div dir="ltr">
<div>
<div>
<div><br>
</div>
<div><i><br>
</i></div>
<div><i><br>
</i></div>
<div><br>
</div>
<div> </div>
</div>
</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<div> </div>
</div>
<br>
<fieldset></fieldset>
<br>
</blockquote>
<br>
</div>
<br>
--<br>
Yanel-usage mailing list <a moz-do-not-send="true"
href="mailto:Yanel-usage@wyona.com" target="_blank">Yanel-usage@wyona.com</a><br>
<a moz-do-not-send="true"
href="http://lists.wyona.org/cgi-bin/mailman/listinfo/yanel-usage"
target="_blank">http://lists.wyona.org/cgi-bin/mailman/listinfo/yanel-usage</a><br>
</blockquote>
</div>
<br>
</div>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
<br>
</body>
</html>