<html>
  <head>
    <meta content="text/html; charset=ISO-8859-1"
      http-equiv="Content-Type">
  </head>
  <body 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:
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    which instructions exactly did you follow? Was it<br>
    <br>
    <a class="moz-txt-link-freetext" href="http://www.yanel.org/download/source-repository.html">http://www.yanel.org/download/source-repository.html</a><br>
    <br>
    ?<br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    do you think we should add a link/note to<br>
    <br>
    <a class="moz-txt-link-freetext" href="http://www.yanel.org/download/source-repository.html">http://www.yanel.org/download/source-repository.html</a><br>
    <br>
    pointing to<br>
    <br>
    <a class="moz-txt-link-freetext" href="http://www.yanel.org/en/getting-started/unix.html">http://www.yanel.org/en/getting-started/unix.html</a><br>
    (or <a class="moz-txt-link-freetext" href="http://www.yanel.org/en/getting-started/windows.html">http://www.yanel.org/en/getting-started/windows.html</a>)<br>
    <br>
    ?<br>
    <br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    where exactly would you add this line?<br>
    Can you send a patch?<br>
    <br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    Can you explain your last setence here what you mean exactly?<br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    yes, I think that would be nice.<br>
    <br>
    Can you open an issue on github and describe this improvement:<br>
    <br>
    <a class="moz-txt-link-freetext" href="https://github.com/wyona/yanel/issues">https://github.com/wyona/yanel/issues</a><br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    I am not sure I understand, can you make an example?<br>
    <br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    I am not sure I understand this either. Can you also explain a bit
    more?<br>
    <blockquote
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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>
    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
cite="mid:CAM6O59dcaV7aiwhe0QUGYwG5Kduo+wV_0EPBzVLYNeKd2FVEBw@mail.gmail.com"
      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 class="mimeAttachmentHeader"></fieldset>
      <br>
    </blockquote>
    <br>
  </body>
</html>