<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 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 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 href="http://www.yanel.org/download/source-repository.html" target="_blank">http://www.yanel.org/download/source-repository.html</a></div>
<div>to <a 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 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><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 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 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 class="gmail_extra"><br></div><div class="gmail_extra">Which improvement to describe in <a 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 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 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 class="gmail_extra">
<br></div><div class="gmail_extra">The last lines (4) and 5)) was just suggestions for a possible improvement. </div></div><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 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 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 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 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 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 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 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 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 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 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 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 href="mailto:Yanel-usage@wyona.com" target="_blank">Yanel-usage@wyona.com</a><br>
<a 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>