WWW-www.enlightenment.org pushed a commit to branch master. http://git.enlightenment.org/website/www-content.git/commit/?id=d175136c1599da2751bc65c75654063f721a4554
commit d175136c1599da2751bc65c75654063f721a4554 Author: apache <[email protected]> Date: Tue Oct 17 00:23:23 2017 -0700 sync edits --- pages/about-ephoto.txt | 4 ++-- pages/docs/c/start.txt | 10 +++++----- pages/start.txt | 1 + 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/pages/about-ephoto.txt b/pages/about-ephoto.txt index 80a5d329..28aad075 100644 --- a/pages/about-ephoto.txt +++ b/pages/about-ephoto.txt @@ -1,7 +1,7 @@ ~~Title: About Ephoto~~ ==== Ephoto - A Comprehensive Image Viewer Using the EFL ==== -[[http://www.smhouston.us/ephoto/|Download Ephoto 1.5 Final]] +[[http://www.smhouston.us/ephoto/|Download Ephoto 1.5 Final] {{:ephoto.png?nolink |}} @@ -28,4 +28,4 @@ Ephoto’s features include: * Applying artistic filters to your image such as black and white and old photo. * Drag And Drop along with file operations to easy maintain your photo directories. -If you have feedback, feature requests, or bug reports, please open a ticket at https://phab.enlightenment.org. +If you have feedback, feature requests, or bug reports, please open a ticket at https://phab.enlightenment.org. \ No newline at end of file diff --git a/pages/docs/c/start.txt b/pages/docs/c/start.txt index fd9abcc1..132d0f6a 100644 --- a/pages/docs/c/start.txt +++ b/pages/docs/c/start.txt @@ -3,7 +3,7 @@ ==== Preface ==== -//This is not a theoretical C language specifications document. It is a practical primer for the vast majority of real life cases of C usage that are relevant to EFL on today's common architectures. It covers application executables and shared library concepts and is written from a Linux/UNIX perspective where you would have your code running with an OS doing memory mappings and probably protection for you. It really is fundamentally not much different on Android, iOS, OSX or even Windows.// +//This is not a theoretical C language specifications document. It is a practical primer for the vast majority of real life cases of C usage that are relevant to EFL on todays common architectures. It covers application executables and shared library concepts and is written from a Linux/UNIX perspective where you would have your code running with an OS doing memory mappings and probably protection for you. It really is fundamentally not much different on Android, iOS, OSX or even Windows.// //It won't cover esoteric details of "strange architectures". It pretty much covers C as a high level assembly language that is portable across a range of modern architectures.// @@ -144,7 +144,7 @@ Variables will live within this memory, and normally the C compiler will deal wi int bob; </code> -You can even tell the compiler to make sure it has an initial value. If you don't it's value may be random garbage that was there before in memory. +You can even tell the compiler to make sure it has an initial value. If you don't, its value may be random garbage that was there before in memory. <code c> int bob = 42; @@ -408,7 +408,7 @@ myfunc(void) } </code> -Another very common use of the pre-processor is to compile only some pieces of code in specific circumstances. A common use-case is for portability (but you can also use this along with #includes, macros etc. to use the pre-processor as a code-generation tool to save a lot of re-typing of almost the same bits of code). On one platform you may have to have some pieces of code work in a specific way that differs from other platforms. This commonly happens with Windows vs Linux vs BSD etc. [...] +Another very common use of the pre-processor is to compile only some pieces of code in specific circumstances. A common use-case is for portability (but you can also use this along with #includes, macros etc. to use the pre-processor as a code-generation tool to save a lot of re-typing of almost the same bits of code). On one platform you may have to have some pieces of code work in a specific way that differs from other platforms. This commonly happens with Windows vs Linux vs BSD etc. [...] You can use this also to compile your code with features enabled or not. You can define pre-processor values on the command line with ''-D'' with most compilers, such as ''-DMY_FEATURE=1'' for example which is the same as putting in the code ''#define MY_FEATURE 1''. You can then have your code be something like: @@ -487,7 +487,7 @@ In memory from start to end it looks like: {{ memory.svg?nolink |Memory layout }} -Note that members will add padding to align members to their natural alignment. This is necessary for correctness and speed reasons across all architectures. Everything is really just a series of bytes in memory. Memory is filled with 1000's or even millions of these bits of data, either one after the other, or spread out. You can jump from one to the other by just using a pointer. Pointers are simply byte numbers from the start of memory (which is 0). The data lives somewhere in memory, [...] +Note that members will add padding to align members to their natural alignment. This is necessary for correctness and speed reasons across all architectures. Everything is really just a series of bytes in memory. Memory is filled with 1000s or even millions of these bits of data, either one after the other, or spread out. You can jump from one to the other by just using a pointer. Pointers are simply byte numbers from the start of memory (which is 0). The data lives somewhere in memory, [...] Generally you allocate memory with functions such as ''malloc()'', ''calloc()'', or ''realloc()''. Some libraries you use may do allocations for you. Be sure to read the manuals on them as well as these above. You would free memory you no longer need with ''free()''. All these functions just take a pointer value that .. points at the memory to free, reallocate, or they return a pointer to this place in memory where your new memory block has been arranged. There are some special functions [...] @@ -509,7 +509,7 @@ If you want to do something privileged, or hide data, it needs to cross a proces The benefit of a shared library is to avoid needing a re-compile to get improvements, save writing all the code the library shares with you, and to share the memory the code in the shared library would consume. As it is a //SHARED// library, the code from that library is loaded only once on the system. It may add to the virtual size of the process, but this space is shared across every process using that library, so the cost is paid just once. -Generally a library exposes an API (a set of functions to call). It will provide header files you #include in your application (or library). You would link to the library and thus, at runtime, the "runtime linker" (ld.so often), will glue in the function symbols in your code to the library you link to. This also is done for global variables exposed by the library as well. This is all done at the start of process startup before the main() function is called. There is a cost to this, but i [...] +Generally a library exposes an API (a set of functions to call). It will provide header files you #include in your application (or library). You would link to the library and thus, at runtime, the "runtime linker" (ld.so often), will glue in the function symbols in your code to the library you link to. This also is done for global variables exposed by the library as well. This is all done at the start of process startup before the main() function is called. There is a cost to this, but i [...] You generally would compile your code to link to a library as follows, assuming the source for your application is ''hello.c'', the binary you wish to output is ''hello'' and the library you want to link to is ''eina'' (often the file on disk will be ''libeina.so'' for the development environment). diff --git a/pages/start.txt b/pages/start.txt index 908b3657..dcf1c121 100644 --- a/pages/start.txt +++ b/pages/start.txt @@ -73,3 +73,4 @@ Many of our **Enlightenment Developer Days** events have been sponsored and paid [[https://www.gandi.net|{{:thanks-gandi.svg|Gandi}}]] [[https://www.samsung.com|{{:thanks-samsung.svg|Samsung}}]] [[https://openwide.fr|{{:thanks-openwide.svg|Openwide}}]] + --
