File	Date	Author	Commit
annex	2019-03-04	Entropy	[cda2bd] Init entropy-emax64.
elements	2019-11-23	Entropy	[8ad685] Update eemacs configuration
test	2019-11-24	Entropy	[fdbd86] Fix previous bug and add command wrappers
.gitignore	2019-06-02	Entropy	[5a4ed7] Bump version to v0.1.4
CHANGELOG.org	2019-06-02	Entropy	[5a4ed7] Bump version to v0.1.4
LICENSE	2019-03-04	Entropy	[cda2bd] Init entropy-emax64.
Makefile	2019-11-24	Entropy	[bd3ee2] Add Makefile
README.org	2019-11-24	Entropy	[f2fd9b] Update README
build_runemacs.sh	2019-11-24	Entropy	[a2b768] Rename stuff
init_entropy-emax64.sh	2019-11-24	Entropy	[bd3ee2] Add Makefile
runemacs.cpp	2019-03-04	Entropy	[cda2bd] Init entropy-emax64.
runemacs.exe	2019-03-04	Entropy	[cda2bd] Init entropy-emax64.
runemacs_icon.rc	2019-03-04	Entropy	[cda2bd] Init entropy-emax64.

Read Me

#+TITLE: Entropy-Emacs portable encapsulation package (entropy-emax64)
#+AUTHOR: Entropy

#+attr_html: :style text-align:center;font-size:1.2em;font-weight:bold;background-color:brown;color:white;padding:1em
*One encapsulation of emacs for windows plattform.*


#+attr_org: :width 200px
#+attr_html: :width 400px
[[file:annex/img/LOGO.png]]

* Preamble

This encapsulation package using [[https://github.com/m-parashar/emax64][emax64 win-port buided binary]] and
[[https://github.com/c0001/entropy-emacs][entropy-emacs]] emacs config project which have the relatively
comprehensive windows adapted sets.

You can use this emacs sets for daily using without the annoying
conflicted emacs config setting on windows. Thus I called this emacs
sets was 'portable'.

I use Msys2 to emulated unix-like environment, thus the emacs config
file and other portable binary package are store in the root of Msys2.

The construct of "elements/Msys2" folder allocation can be see below:

- "portbale-home" folder:

  This folder was the place where droped *entropy-emacs* emacs config
  and also was the home path for this portable emacs distribution. You
  can place any dot file here as what you do in unix-like operation
  system.

- "wsl-portable" folder:
  
  This folder contained "node-js-portable", "pandoc-portable" and
  other lightweght portable development binary file which you can
  using it out of box immediately.

  The basic setting for adding mintty for emacs and the magit git
  executable have been setting with distribution of this repo, so you
  don't need to manually do them any more. But anything like java, go
  etc. portable binary you want to get, you must download them from
  their official website and put them here, setting environment
  variable will be by you self. You can do the same thing that what
  you do in the way by using standalone "entropy-emacs" emacs-config.


* Usage:

Whenever the first time to use eemax64 or for updating scene, run
~make~ before every operation.
  
** First time experiencing

When the first time cloning this project, the user space was clean,
the time as what you should do was that:

#+BEGIN_SRC shell
  make init
#+END_SRC

This behaviour will downloading each =entropy-emax64= dependencies of
some internal defined utilities such as =Msys2=, =git-bash=, OFC for
the basic programming envrionment backends as nodejs php python
texlive and so on. Thus for retrieving the project dependencie, you
must have the unobstructed Internet environment, the situation for
some WWW charged country, the VPN or the proxy were need to as.

With inited by running after the whole scripts by as non-problem, you
could run the =runemacs.exe= under root of repo. Thus here what for
you is the whole initialization.

** Environment updating

As for the project updating for =entropy-emax64=, there's two updating
type chosen for what you needed e.g. 1) project config file updating
or 2) utilities updating.

*** Common updating

entropy-emax64 archived some configuration as template for project
init and updating as, all of them are stored in
=elements/entropy-emax64_template= directory. This templates are
charged of =git=, which shows that you shouldnn't editting them unless
the temperally testing bug for sending for this project official site,
otherwise you should checkoutiing them after did that.

=entropy-emax64= gives sets of portability configuration of Msys2 and
emax64 which stored in that dir mentioned above, you can view them for
more detailes. There's also some facilities ready-made configuration
as.

For update or the order for reset them, you can run ~make~ with =update=
option:
: make update

That's all, do it following the cli prompting chooing the common
updating type.


*** Utilityies updating

with the updating of =entropy-emax64=, all thirdy utilities maybe
updating by the upstream, at this time, you could updating those by
the =utilities updating= type by input '2' as the same step as common
configuration updating.

These procedure can also be the utilities reset optional step in the
case of you have messed up your utilities folder e.g. python, nodjs
etc.

** Usage Notice

When the first time initializing this repo, all the third party
utilities will archived in =wget_cache= dir under the root of
this. Thus the content checking or the version question can be throw
out, the main reason for remaining the caching was reducing the
following package resetting without network working.

All Msys2 environment won't be version charged, as the benefit for
your updating to date. As same for other utilities, see =.gitignore=
for the details.

* Tips:

The config folder was git-repo as complete as you cloning it form
https://github.com/c0001/entropy-emacs. So you can update the config
file as the normal way for doing with other-repo.

# Local Variables:
# org-adapt-indentation: nil
# End: