[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, cmake, updated. gawk-4.1.0-885-g14da33f
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, cmake, updated. gawk-4.1.0-885-g14da33f |
|
Date: |
Mon, 13 Oct 2014 08:57:15 +0000 |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, cmake has been updated
via 14da33f5ac17b4adfd15ddb12c07715741bd1b1f (commit)
via ef6390b3a9e42186ca520f4a732c6b4e4b1a093d (commit)
via 0485d6bfe2417a7640ef95c9de6f48e1f35003fd (commit)
via 2a8c128ca91b42261720368e5d25431ee4362c70 (commit)
via 8529cd991d329ca9f17da5d75320248a86400f3d (commit)
via 13bfd4900cb896756442778d82b3be3bac074b32 (commit)
via 5e73f350819b4cd9efb0d50b8a57e50ab271dcda (commit)
via 964e19b54a9ee3e03658e2a733c1b50ee8624397 (commit)
via de578ef8fa4fecfda01ead45ea24ef3b64b7d1b0 (commit)
via 2711b6286b4929e20289a318fceac67025db92d6 (commit)
via 78d374fdffd6d83b559393a00a6f69804d6e5c4d (commit)
via 3c4daf4e10892a471111a95f62d99d660ab24552 (commit)
via e86f9bcc463370f27f005439c2d8bb73a0caafbd (commit)
via 0e8a103b9aa1f2411fba665d1656f28fa297e874 (commit)
via 62988ea2ac1f845e30c3986bfc9bf4620693682a (commit)
via c86aa5e85c7ced14a81389c0bf96b6c75fe420c9 (commit)
via 6b818c7f463e1bd6b9470f4bfb694f240ac3e5c2 (commit)
via 2f7402ec4b65a2546373403fa701a29d7482cf3f (commit)
via abce1669d0d0e571687b73db8810a9a3a3a3d8e5 (commit)
via 5bbb7a9ec75b08d29557876bb77f9c4349e17ce8 (commit)
via 0054d8fc4f53f27817764dee7bac7ec36fd312f8 (commit)
via 42bcb6246432790af31958d5445cd035fe9966a5 (commit)
via abff9b12506c0b8d971a7b6c9b08ada126d67e0d (commit)
via c8a4f8fef51ee2da94cec60017765bba9b1ea61b (commit)
via c7a0e4b598a39084c288f975a59549b6068051cf (commit)
via 4959339c8a962b54bf33fd9e3d9f46b3f1c3c29e (commit)
via 3225a4e4256d827a521c7127620e34a167f6e195 (commit)
via 510b5a48ec42ca1335b61421d40f9914db6f9d07 (commit)
via da40c668c34535b7068bd1d228d6debaf2fb7bb6 (commit)
via bef9bb953fe57ad027d596501b64230b526f0fda (commit)
via ed633f19bdbb66ac12aaf66cf46b458558eaedbd (commit)
via db0190d23e173d1869906385d00f3cbc01559b72 (commit)
via 96490f609bec8ee0b1827faf893d0f6daecc9a53 (commit)
via 7773dc0b5d21792fb55bc52f992c7a5b7239140f (commit)
via 63cf4c66e97a92f3e553707ecd0bc278a7cc4563 (commit)
via a2a68eaafd161190d15a42cb2d54e297c5263860 (commit)
via 6bdad20131c002ae3d293dcfc98792a197a782dd (commit)
via 63c4c29e1ebfb0e68fe622bea1c4ed82ac6a6a02 (commit)
via d58dd2f32dc90742a9759b70114a39a55550a66a (commit)
via 2072cca806ac43a5ee0d422749e9e0c5f7611d47 (commit)
via abcfb997622f9b65c9f142b178648bbda83acdf1 (commit)
via 1086474bc51fc31e15d72df27b529b1015cd33aa (commit)
via 67676f7332c2fa2ab6eb4411993fa77e92df5828 (commit)
via af7c51f9bfbded58d306e4f0e05b580457e7e92f (commit)
via b8ec82d647b7455cc89fc911eba04513ae6d9653 (commit)
via 31d26ad56d0616672303d2d949a3772afc35e33b (commit)
via df3fe55e08cf4e8575e7b3d6ea38fd1cf9a9ca2e (commit)
via 591925d885e736007f05854226b5f65ae06ad0a7 (commit)
via 25a11929d27188ef28be2b671f895df347a15024 (commit)
via 342139ab3ed41800b6844c11efaaa21b2bc61b36 (commit)
via 983b6996b019850733fc9cd2ea57352f9dbbf7d8 (commit)
via 9701514d4ad1152da564ebf6690c514becd4339a (commit)
via e71e74ac9af232d58e6c672e37ddf7e8737d68b1 (commit)
via 66479f2ca1fbbf3b96cd2e1b15c0119b209df54a (commit)
via 6f66d82e5794022ec2873d1f3ccba8e1267ca9a3 (commit)
via eeb0b5d5b0791c580e49e7a6ca4f844f2a0edabb (commit)
via c7882f59b6e5e4bb142928939264ca0c9af8e129 (commit)
via 2a4725673f46d42cddff89b7002b193c67222c85 (commit)
via 32649f52d26b1c3a6d09ffbca04928b476698713 (commit)
via ffab492af7444f26e3eb4945700cf72841a36e6e (commit)
via fc9b58482ce186b2fa0461351d4e060735e21b78 (commit)
via 6641754c13e38dd6198832f23aa2be4b4546b324 (commit)
via 06e16db227de0422f33b5f83817df55340f11846 (commit)
via ce2747c81b98b70e75ec399c8bdc6c09308380d3 (commit)
via eff1b6b21720518f2ea9dbd862fe3844d899db08 (commit)
via 8b4e8f702df30b2b2238158504de5d8eb436958d (commit)
via 4dcc853c04e05a88e2c07125bf3e7ab75cbcb6ca (commit)
via 6b1b9c16a1b55804df36457de0650414ab3f017d (commit)
via 664c9b943aecbbf22c591608f26809b10cf4546e (commit)
via ba56be212f9dee0088322e1560f31b3f4693633d (commit)
via 9a124d5aace4595c715665f3b5411f7d0a68c3a1 (commit)
via 3c1052d3020c5b3ac7361ab7a706bcb83af05b30 (commit)
via 7ac81efe10795318427ad71f9c05b9c93442acfb (commit)
via dc510090126eb27d2e0514f42a4da4863873903d (commit)
via 3fcce8a32e825dd10384d5276c420c2514442fe2 (commit)
via 23681ec5b179a4e981781ce2daa08f61cb7317d4 (commit)
via 8a1df492afae19d544fa5e5b636ed427b2d1c3f5 (commit)
via 7796fb7a2e70c0252531bd224889baccacae1c9e (commit)
via 1684dfc1f5abd1e0093feb586ae428ce42d1a827 (commit)
via 2323f97d55a79c302457d75443b2ffd529983083 (commit)
via bfc92908704856d136b8eee3a03ea7f6bb868c2e (commit)
via f671c30534a2e3b0675f81cbb82f0d0e82ace6c3 (commit)
via dc03ae8d25acc19f27f015ab568e07f7d24fe2f6 (commit)
via 33acaac51cd9087eb7a9b7e73c11f58da396df9a (commit)
via 9b21de890a81179e951ffa5bea2099673f584b16 (commit)
via 5d0e35df699f96e1f22af4d8f4cffab355c82913 (commit)
via 6de0102373304c0fdf70a7ddeb17dd1caa3a9b23 (commit)
via d7c8dfd41bd5671ddfa6c81b2ef1779cab06e56b (commit)
via f7cd8393105d286074d6e1a918b4fd6228f00245 (commit)
via 01629cb09cce23f1b8c014280b97a2f19ca34e25 (commit)
via ae1c0daca3998e5be8369e632e093f9f6dce1a70 (commit)
via ca9f23d6c33c4b5cb3786d480948a42988ca99ac (commit)
via 9da96e570a835d6a0427c9182585af307d393f45 (commit)
via a1df6304be3c217877919097d2e4b3b16de6cd02 (commit)
via c037ac7669150fbc955313fa63928fe00d3c825d (commit)
via f9fadc3b2bf0bf9d65a981a712aa9aebc21a699b (commit)
via 01c916919342d33cddfadb89b0b4e0ad6f6201f0 (commit)
via 1cc790ecafc378da1dbbda8480a2a41f13c1821e (commit)
via 4282c7757598300ee050374f3649ffee070ed680 (commit)
via 4585a0f2ec53a3d26646925ad269acb9c861347a (commit)
via 4e463bfa0ca3d2e317a0d6afe0badd6b7ee4a001 (commit)
via c59f2580c1c2e3ac399c7fd33a860470e58ca76a (commit)
via 0f5cb955662136ad4a93e35db5721dd986dfd55b (commit)
via 3f30f514c6e81c4a9e8ba1374a5080683783c382 (commit)
via c30a04c8d3a2eef06338934f577fe3416f40d529 (commit)
via 16a26e063e9c62bff0478fa210d875c4eed2b7c0 (commit)
via 7448f28d356fc5cd8d9117111baea3a549e0930e (commit)
via 8beb9796b17b6ca48eb62df8fd3d31421e43c761 (commit)
via 611353597e20081bd0c72617e24fa5ff4c63dac1 (commit)
via cb92ab7aa657c57446cc9e0087f1364adaac8fee (commit)
via a0d7edfff1b489e50ae8751429ebf925948b746f (commit)
via ae131ae925aa5ba54fb7f8ae105e5cbbf3655f06 (commit)
via a205df7903bce201577df4f7049c190e283f1ea4 (commit)
via f84a4ffb830e5f9ce138cb74fae99ad930805723 (commit)
via fb838ec318104f66a36e59f71ffb4f9eaa9b2eaa (commit)
via 2783f2c7d4e52fa7accfba7b847c416d8c71cd0f (commit)
via bfc794de222760871c6c6de6bb923a0bf57ee166 (commit)
via 00f86a1d837f838a715dc879076325f772c4c5c9 (commit)
via ba1e7ab66563efb5b597a418e2e9fb4a01998d03 (commit)
via 6c541fd0f75cd328dd80afec757ecccc833719af (commit)
via 5a05ddf24b9f5ebc81a1b295ba7a6fbc7348776b (commit)
via ff28c07f95ff2400eb0ad1becc0eae1eab9dc93d (commit)
via 3a2e4e1b409d87ade30d3ad2976695235347f13b (commit)
via a5847cb0a97b093cd0f23b65c72370af836c9748 (commit)
via b52b7b9f65b0edfe28f0b16a4aa72f1b76cf8820 (commit)
via 12e05615041147de61658bda8f5e7d5a4acd87c3 (commit)
via 73780a2b7c4a873c6844a489856b5ae2fe1a9c64 (commit)
via 5167f5aaabb5adb4801be9f46ba3ba16596014c3 (commit)
via ccac19d49a596ba9eaef739cbc9dd4ebf87c8a24 (commit)
via cd3f4b04ef1a3a0027e72ed6d7af2fcab5ca64df (commit)
via 12cd52d7342ec15db88fbbcb4e75af53406c0c49 (commit)
via 8006ef4ca16fa8264dcc1e849783e1f4ce4978a1 (commit)
via 9a7e5828f29d3f5daba5dc5ef1f6b9cd87f596b8 (commit)
via 056c0179993b718d7859618023fd549c766e479f (commit)
via 3defec04e39c4ca6987a21f79686576d9823c653 (commit)
via 8f2c2755573b81c1e2c9ef1c42c529d13396d4d2 (commit)
via 09dca22666681470a207083f339083a1a4a8c973 (commit)
via 4425e6c5b88ecc03371b68926ebf89ebe03839ba (commit)
via d60fb05cc5db4f1ee1176a9ed7f053011f8521aa (commit)
via cafa8fcd5a5d593f4638b199fbf5f94a006a4aac (commit)
via de3372f0d98c7137823e7d5630d03429bb77d1f2 (commit)
via ebb6772e9eabeb81e3cc9305a6bec7adf7aad450 (commit)
via e069c636968370f0899d5e4ebaeb9c2341804245 (commit)
via 624d70844fe63068132adb7c66ea3f8a231e56a7 (commit)
via da83b6857bf0a67b15fc75d31a0b6802ac9baffe (commit)
via e149eb882355f427d43928324145c971a0562c5e (commit)
via 1457aab67141409f57d25c06f86e227d92808da3 (commit)
via afc5c481f97b85b803b9b973d52684deceb715d0 (commit)
from 7504a8fbc86b327ad07c79c943b8fe2d253f256d (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=14da33f5ac17b4adfd15ddb12c07715741bd1b1f
commit 14da33f5ac17b4adfd15ddb12c07715741bd1b1f
Author: Arnold D. Robbins <address@hidden>
Date: Mon Oct 13 11:56:48 2014 +0300
Cleanups in using-git.texi before starting real work on it.
diff --git a/doc/using-git.texi b/doc/using-git.texi
index 2a17c8e..c5692ce 100644
--- a/doc/using-git.texi
+++ b/doc/using-git.texi
@@ -83,17 +83,14 @@ texts being (a) (see below), and with the Back-Cover Texts
being (b)
@enumerate a
@item
-``A GNU Manual''
-
address@hidden
-``You have the freedom to
-copy and modify this GNU manual. Buying copies from the FSF
-supports it in developing GNU and promoting software freedom.''
+The FSF's Back-Cover Text is: ``You have the freedom to
+copy and modify this GNU manual.''
@end enumerate
@end copying
@ifinfo
-This file documents the workflow of the developers in the GNU @command{awk}
project.
+This file documents the workflow of the developers in the GNU
address@hidden project.
@insertcopying
@end ifinfo
@@ -139,7 +136,7 @@ ISBN 1-882114-93-0 @*
@end iftex
@ifnottex
address@hidden Top, Preface, (dir), (dir)
address@hidden Top
@top Introduction
@comment node-name, next, previous, up
@@ -150,20 +147,47 @@ version 4.1 and later.
@end ifnottex
@menu
-* Introduction:: About networking.
-* Basics of GIT repositories:: The fundamental environment of the
developer.
-* Conventions used in the repository:: How to behave.
-* Tutorial for a first-time-gawk-contributor:: How to get started with least
pain.
-* FAQs and HOWTOs:: General recipes for daily work.
-* Links:: Where to find the stuff mentioned in this
- document.
-* GNU Free Documentation License:: The license for this document.
-* Index:: The index.
+* Introduction:: About networking.
+* Basics of GIT repositories:: The fundamental environment of
+ the developer.
+* Conventions used in the repository:: How to behave.
+* Tutorial for a first-time-gawk-contributor:: How to get started with least
+ pain.
+* FAQs and HOWTOs:: General recipes for daily work.
+* Links:: Where to find the stuff
+ mentioned in this document.
+* GNU Free Documentation License:: The license for this document.
+* Index:: The index.
+
address@hidden
+* Quick Start::
+* Setting up a proper @command{git} repository::
+* Pulling the latest changes from the remote repository::
+* Checking out a feature branch from the remote repository::
+* Semantics of Cloning:: What to
+ consider
+ before you
+ clone.
+* Local versus Remote:: Where my
+ source code
+ really is.
+* Tracking and Merging:: What the
+ others are
+ doing.
+* master::
+* stable::
+* feature::
+* who does what::
+* step-by-step instructions for a first-time-gawk-contributor::
+* step-by-step instructions for a first-time-gawk-administrator::
+* general recipes for daily work::
+* references and URLs to books and other texts::
address@hidden detailmenu
@end menu
@contents
address@hidden Introduction, Basics of GIT repositories, Top, Top
address@hidden Introduction
@chapter Introduction
This @value{DOCUMENT} is meant to be a description of the working habits
@@ -178,8 +202,16 @@ We hope that (in later, more abstract steps) you will
always remember
this down-to-earth introduction, should you ever wonder what all the
later bizarre trickery is good for.
address@hidden Quick Start: Compiling @command{gawk} in 5 Minutes, Setting up a
proper @command{git} repository, Introduction, Introduction
address@hidden
+* Quick Start::
+* Setting up a proper @command{git} repository::
+* Pulling the latest changes from the remote repository::
+* Checking out a feature branch from the remote repository::
address@hidden menu
+
address@hidden Quick Start
@section Quick Start: Compiling @command{gawk} in 5 Minutes
+
The following steps will look familiar to you, they are not that much
different from the steps you used in the old days when you downloaded
a tar ball, extracted it and compiled the source code. It is mainly
@@ -188,18 +220,23 @@ tar ball you need the tool @command{git}.
@footnote{If the command @command{git} does not exist on your machine,
you need adminstrator privileges to install it. By convention, the
command is usuallay part of an installation package by the same name.}
+
@example
- git clone git://git.savannah.gnu.org/gawk.git
- cd gawk
- git checkout master
- ./configure
- make
- ./gawk --version
+git clone git://git.savannah.gnu.org/gawk.git
+cd gawk
+git checkout master
+./bootstrap.sh
+./configure
+make
+./gawk --version
@end example
+
+FIXME: add bootstrap. Also default is master
+
The only other difference to your working habits is the third step;
you have to extract the @emph{master} branch of the current source
code (there are other branches available, that's the point where
-things get interesting). Isn't this simple ? No, it's not that simple.
+things get interesting). Isn't this simple? No, it's not that simple.
If you plan to go any step further (for example compile the source
code again next week, including next week's latest update), you will
need to know what's going on when you use this seemingly simple
@@ -210,8 +247,9 @@ explanation, here we are satisfied with getting to know the
practical
steps necessary to get a working environment going that you can use
in your daily work in a reliable way.
address@hidden Setting up a proper @command{git} repository, Basics of GIT
repositories, Introduction, Introduction
address@hidden Setting up a proper @command{git} repository
@section Setting up a proper @command{git} repository
+
After the initial @emph{checkout} you have access to all the source code
files that the maintainers have pushed through the official release procedure.
You may not have noticed, but each change is well documented and traceable.
@@ -238,9 +276,9 @@ some global variables identifying you. The global settings
will be used
every time you connect again to the @emph{upstream} repository.
@smallexample
- git config --global user.name "@emph{First-Name Last-Name}"
- git config --global user.email @emph{email@@address.site}
- git config --global color.ui auto
+git config --global user.name "@emph{First-Name Last-Name}"
+git config --global user.email @emph{email@@address.site}
+git config --global color.ui auto
@end smallexample
You may leave these variables unset, but then you are reduced to an
@@ -252,22 +290,22 @@ use cases, but that comes at a cost: With so many helpful
defaults
you may be overwhelmed by the detail and complexity of the real inner working.
@smallexample
- git config --list
- user.name=First-Name Last-Name
- user.email=email@@address.site
- color.diff=auto
- color.status=auto
- color.branch=auto
- gui.spellingdictionary=en_US
- core.repositoryformatversion=0
- core.filemode=true
- core.logallrefupdates=true
- remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
- remote.origin.url=ssh://jkahrs@@git.sv.gnu.org/srv/git/gawk.git
- branch.master.remote=origin
- branch.master.merge=refs/heads/master
- branch.xgawk_load.remote=origin
- branch.xgawk_load.merge=refs/heads/xgawk_load
+$ @kbd{git config --list}
address@hidden user.name=First-Name Last-Name
address@hidden user.email=email@@address.site
address@hidden color.diff=auto
address@hidden color.status=auto
address@hidden color.branch=auto
address@hidden gui.spellingdictionary=en_US
address@hidden core.repositoryformatversion=0
address@hidden core.filemode=true
address@hidden core.logallrefupdates=true
address@hidden remote.origin.fetch=+refs/heads/*:refs/remotes/origin/*
address@hidden remote.origin.url=ssh://jkahrs@@git.sv.gnu.org/srv/git/gawk.git
address@hidden branch.master.remote=origin
address@hidden branch.master.merge=refs/heads/master
address@hidden branch.xgawk_load.remote=origin
address@hidden branch.xgawk_load.merge=refs/heads/xgawk_load
@end smallexample
Changing these variables with specialized variants of the @command{git} command
@@ -275,21 +313,21 @@ may seem awkward to you and perhaps you prefer to use
your favourite text editor
to overview and change the variables.
@smallexample
-vi .git/config
-[core]
- repositoryformatversion = 0
- filemode = true
- bare = false
- logallrefupdates = true
-[remote "origin"]
- fetch = +refs/heads/*:refs/remotes/origin/*
- url = ssh://jkahrs@@git.sv.gnu.org/srv/git/gawk.git
-[branch "master"]
- remote = origin
- merge = refs/heads/master
-[branch "cmake"]
- remote = origin
- merge = refs/heads/cmake
+$ @kbd{cat .git/config}
address@hidden [core]
address@hidden repositoryformatversion = 0
address@hidden filemode = true
address@hidden bare = false
address@hidden logallrefupdates = true
address@hidden [remote "origin"]
address@hidden fetch = +refs/heads/*:refs/remotes/origin/*
address@hidden url = ssh://jkahrs@@git.sv.gnu.org/srv/git/gawk.git
address@hidden [branch "master"]
address@hidden remote = origin
address@hidden merge = refs/heads/master
address@hidden [branch "cmake"]
address@hidden remote = origin
address@hidden merge = refs/heads/cmake
@end smallexample
Now you can see how variables are structured group-wise.
@@ -301,13 +339,13 @@ The e-mail address is a variable of a more general kind
that
should be stored above all the repositories.
@smallexample
-git config --list --global
-user.name=First-Name Last-Name
-user.email=email@@address.site
-color.diff=auto
-color.status=auto
-color.branch=auto
-gui.spellingdictionary=en_US
+$ @kbd{git config --list --global}
address@hidden user.name=First-Name Last-Name
address@hidden user.email=email@@address.site
address@hidden color.diff=auto
address@hidden color.status=auto
address@hidden color.branch=auto
address@hidden gui.spellingdictionary=en_US
@end smallexample
If you wonder whether there is a parameter @command{--local} to list
@@ -319,17 +357,22 @@ but one day you might appreciate it.
git help config
@end smallexample
address@hidden Pulling the latest changes from the remote repository
@section Pulling the latest changes from the remote repository
+
Whether you set any of these variables or not, sooner or later you will want
to catch up with the changes that happened in the upstream repository.
So, how can you update your copy of the repository and re-build the source
code?
The easiest way is to rely on defaults and use the @emph{pull} command to
request
updates from the upstream repository.
+
@smallexample
- git pull
- ./configure
- make
+git pull
+./bootstrap.sh
+./configure
+make
@end smallexample
+
When using the @emph{pull} command, all the changes available in all branches
of
the upstream repository will be copied (and merged) into your local repository.
We assume here that we still have the @emph{master} branch checked out (as
described earlier)
@@ -340,26 +383,32 @@ But @emph{what is a branch?} you may wonder. It is the
name given to a sequence
that were made to the master branch outside the master branch.
It is easy to look up all the available branches
(the names of the change sequences) in the remote upstream repository.
+
@smallexample
- git branch -a
-* master
- remotes/origin/cmake
+$ @kbd{git branch -a}
address@hidden * master
address@hidden remotes/origin/cmake
@end smallexample
+
The asterisk in front of the branch name assures you of the fact that you see
the source files as they are in the @emph{master} branch.
address@hidden Checking out a feature branch from the remote repository
@section Checking out a feature branch from the remote repository
+
It is also easy to
have a look at other branches, for example when you are interested in what is
going on in a certain @emph{feature branch} that the maintainer set up recently
for a new feature to be developed separately (so that others can go on
undisturbed).
+
@smallexample
- git checkout origin/cmake
- git branch -a
- master
-* remotes/origin/cmake
- ./configure
- make
+$ @kbd{git checkout origin/cmake}
+$ @kbd{git branch -a}
address@hidden master
address@hidden * remotes/origin/cmake
+$ @kbd{./bootstrap.sh}
+$ @kbd{./configure}
+$ @kbd{make}
@end smallexample
When you try this, take care that you have not changed anything in any source
file.
@@ -367,33 +416,46 @@ When you try this, take care that you have not changed
anything in any source fi
This is meant to protect you from losing any local changes that you forgot to
save.
Any source file that is part of the repository and gets generated during the
build
in a slightly different way than the original would cause such a problem.
+
@smallexample
-git status
-# On branch master
-# Changes not staged for commit:
-# awkgram.c
+$ @kbd{git status}
address@hidden # On branch master
address@hidden # Changes not staged for commit:
address@hidden # awkgram.c
@end smallexample
+
Here we have @file{awkgram.c} that was generated from @file{awkgram.y}.
But what was generated differently in the file?
+
@smallexample
git diff awkgram.c
@end smallexample
+
Ok, you are not interested in textual changes to the copyright notice
that are only due to a new calendar year. You are also not interested
in the internals of the generated parser and only wonder
@emph{How do we get back the original file from the repository?}
+
@smallexample
-git checkout awkgram.c
-git diff awkgram.c | wc -l
-0
+$ @kbd{git checkout awkgram.c}
+$ @kbd{git diff awkgram.c | wc -l}
address@hidden 0
@end smallexample
+
After checking the file out once more, there is obviously no difference
to the copy saved in the repository. But let's not get distracted, we
wanted to find out what was going on in this feature branch. We can
find out by asking @command{git} what has changed in the file @file{ChangeLog}
of this feature branch relative to the master branch.
+
@smallexample
git diff origin/master ChangeLog
address@hidden smallexample
+
address@hidden
+This produces:
+
address@hidden
diff --git a/ChangeLog b/ChangeLog
index eab657c..a499ec5 100644
--- a/ChangeLog
@@ -407,14 +469,17 @@ index eab657c..a499ec5 100644
- * symbol.c (make_symbol, install, install_symbol): Add const to
- first parameter. Adjust decls and fix up uses.
@end smallexample
+
Looks like a minor cleanup operation in the master branch that has not
yet been merged into the feature branch. We still don't know what is new
in this feature branch, how can we know? By looking at all changes that exist.
+
@smallexample
-git diff origin/master --numstat
-0 78 ChangeLog
-8 3 README_d/README.cmake
+$ @kbd{git diff origin/master --numstat}
address@hidden 0 78 ChangeLog
address@hidden 8 3 README_d/README.cmake
@end smallexample
+
On your screen you see a list of all differences between the currently
checked-out branch and the master branch. It tells you the names of the
files that have changed, along with the number of added and deleted lines.
@@ -423,10 +488,15 @@ Let's single out one particular file that looks
interesting.
As usual there is a @command{diff} sub-command to list all the changed
lines, but there is also a @command{blame} sub-command that tells you
who made the last change to any of the lines.
+
@smallexample
-git diff origin/master README_d/README.cmake
-..
git blame README_d/README.cmake
address@hidden smallexample
+
address@hidden
+This produces (in part):
+
address@hidden
2092a35f (Juergen Kahrs 2014-08-12 17:11:20 +0200 1) CMake is a build
automation system
2092a35f (Juergen Kahrs 2014-08-12 17:11:20 +0200 2)
http://en.wikipedia.org/wiki/Cmake
2092a35f (Juergen Kahrs 2014-08-12 17:11:20 +0200 3)
@@ -434,6 +504,7 @@ git blame README_d/README.cmake
2092a35f (Juergen Kahrs 2014-08-12 17:11:20 +0200 5) This attempt is
currently only experimental. If you wonder why anyone
2092a35f (Juergen Kahrs 2014-08-12 17:11:20 +0200 6) should do this, read
@end smallexample
+
The strange number on the left margin is the short form of a numerical
identifier of the change set. At the moment you can safely ignore it,
but this number is the key you need in case you should ever want to
@@ -443,13 +514,13 @@ local repository and @command{push} them to the upstream
repository.
Some conceptual basics are needed for understanding this essential part
of the workflow.
-
address@hidden Basics of GIT repositories, Conventions used in the repository,
Compiling @command{gawk} in 5 minutes, Top
address@hidden Basics of GIT repositories
@chapter Basics of GIT repositories
+
@menu
-* Semantics of Cloning:: What to consider before you clone.
-* Local versus Remote:: Where my source code really is.
-* Tracking and Merging:: What the others are doing.
+* Semantics of Cloning:: What to consider before you clone.
+* Local versus Remote:: Where my source code really is.
+* Tracking and Merging:: What the others are doing.
@end menu
@c http://iverilog.wikia.com/wiki/Installation_Guide
@@ -464,6 +535,7 @@ of the workflow.
What is tracking ?
address@hidden
- How can I use git to contribute source code ?
You need an account at Savannah. Read this to understand the first steps:
http://savannah.gnu.org/maintenance/UsingGit
@@ -473,30 +545,51 @@ Then you are ready to checkout. Remember that (when
cloning) you are
setting up your own local repository and make sure you configure it
properly.
git clone ssh://my_account_name@@git.sv.gnu.org/srv/git/gawk.git
address@hidden display
address@hidden Semantics of Cloning, Local versus Remote, Introduction,
Introduction
address@hidden Semantics of Cloning
@section Semantics of Cloning
address@hidden Local versus Remote, Tracking and Merging, Semantics of Cloning,
Introduction
address@hidden Local versus Remote
@section Local versus Remote
address@hidden Tracking and Merging, Conventions used in the repository, Local
versus Remote, Introduction
address@hidden Tracking and Merging
@section Tracking and Merging
address@hidden Conventions used in the repository, Tutorial for a
first-time-gawk-contributor, Basics of GIT repositories, Top
address@hidden Conventions used in the repository
@chapter Conventions used in the repository
+
address@hidden
+* master::
+* stable::
+* feature::
+* who does what::
address@hidden menu
+
address@hidden master
@section master
+
address@hidden stable
@section stable
+
address@hidden feature
@section feature
+
address@hidden who does what
@section who does what
address@hidden Tutorial for a first-time-gawk-contributor, FAQs and HOWTOs,
Conventions used in the repository, Top
address@hidden Tutorial for a first-time-gawk-contributor
@chapter Tutorial for a first-time-gawk-contributor
address@hidden step-by-step instructions for a first-time-gawk-contributor,
step-by-step instructions for a first-time-gawk-administrator, Conventions
used in the repository, Tutorial for a first-time-gawk-contributor
address@hidden
+* step-by-step instructions for a first-time-gawk-contributor::
+* step-by-step instructions for a first-time-gawk-administrator::
address@hidden menu
+
address@hidden step-by-step instructions for a first-time-gawk-contributor
@section step-by-step instructions for a first-time-gawk-contributor
address@hidden step-by-step instructions for a first-time-gawk-administrator,
FAQs and HOWTOs, Tutorial for a first-time-gawk-contributor, Tutorial for a
first-time-gawk-contributor
address@hidden step-by-step instructions for a first-time-gawk-administrator
@section step-by-step instructions for a first-time-gawk-administrator
@c e-mail from Arnold 2014-08.24
@@ -528,16 +621,28 @@ properly.
@c I think I actually prefer that behavior, since it's more intuitive to me.
address@hidden FAQs and HOWTOs, Links, Tutorial for a
first-time-gawk-contributor, Top
address@hidden FAQs and HOWTOs
@chapter FAQs and HOWTOs
+
address@hidden
+* general recipes for daily work::
address@hidden menu
+
address@hidden general recipes for daily work
@section general recipes for daily work
address@hidden Links, GNU Free Documentation License, FAQs and HOWTOs, Top
address@hidden Links
@chapter Links
+
address@hidden
+* references and URLs to books and other texts::
address@hidden menu
+
address@hidden references and URLs to books and other texts
@section references and URLs to books and other texts
@c The GNU Free Documentation License.
address@hidden GNU Free Documentation License, Index, Links, Top
address@hidden GNU Free Documentation License
@unnumbered GNU Free Documentation License
@cindex FDL (Free Documentation License)
@cindex Free Documentation License (FDL)
@@ -1048,7 +1153,7 @@ to permit their use in free software.
@c End:
address@hidden Index, , GNU Free Documentation License, Top
address@hidden Index
@comment node-name, next, previous, up
@unnumbered Index
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=ef6390b3a9e42186ca520f4a732c6b4e4b1a093d
commit ef6390b3a9e42186ca520f4a732c6b4e4b1a093d
Author: Arnold D. Robbins <address@hidden>
Date: Mon Oct 13 11:56:15 2014 +0300
Sync the generated doc files with master.
diff --git a/doc/gawk.info b/doc/gawk.info
index caa557e..4e8b653 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -19818,8 +19818,7 @@ output. They are as follows:
you typed when you wrote it. This is because `gawk' creates the
profiled version by "pretty printing" its internal representation of
the program. The advantage to this is that `gawk' can produce a
-standard representation. The disadvantage is that all source-code
-comments are lost. Also, things such as:
+standard representation. Also, things such as:
/foo/
@@ -19881,6 +19880,22 @@ without any execution counts.
NOTE: Once upon a time, the `--pretty-print' option would also run
your program. This is is no longer the case.
+ There is a significant difference between the output created when
+profiling, and that created when pretty-printing. Pretty-printed output
+preserves the original comments that were in the program, although their
+placement may not correspond exactly to their original locations in the
+source code.
+
+ However, as a deliberate design decision, profiling output _omits_
+the original program's comments. This allows you to focus on the
+execution count data and helps you avoid the temptation to use the
+profiler for pretty-printing.
+
+ Additionally, pretty-printed output does not have the leading
+indentation that the profiling output does. This makes it easy to
+pretty-print your code once development is completed, and then use the
+result as the final version of your program.
+
File: gawk.info, Node: Advanced Features Summary, Prev: Profiling, Up:
Advanced Features
@@ -32377,7 +32392,7 @@ Index
* dump debugger command: Miscellaneous Debugger Commands.
(line 9)
* dupword.awk program: Dupword Program. (line 31)
-* dynamic profiling: Profiling. (line 179)
+* dynamic profiling: Profiling. (line 178)
* dynamically loaded extensions: Dynamic Extensions. (line 6)
* e debugger command (alias for enable): Breakpoint Control. (line 73)
* EBCDIC: Ordinal Functions. (line 45)
@@ -32748,7 +32763,7 @@ Index
(line 44)
* G-d: Acknowledgments. (line 94)
* Garfinkle, Scott: Contributors. (line 34)
-* gawk program, dynamic profiling: Profiling. (line 179)
+* gawk program, dynamic profiling: Profiling. (line 178)
* gawk version: Auto-set. (line 214)
* gawk, ARGIND variable in: Other Arguments. (line 15)
* gawk, awk and <1>: This Manual. (line 14)
@@ -32939,7 +32954,7 @@ Index
* history expansion, in debugger: Readline Support. (line 6)
* histsort.awk program: History Sorting. (line 25)
* Hughes, Phil: Acknowledgments. (line 43)
-* HUP signal, for dynamic profiling: Profiling. (line 211)
+* HUP signal, for dynamic profiling: Profiling. (line 210)
* hyphen (-), - operator: Precedence. (line 52)
* hyphen (-), -- operator <1>: Precedence. (line 46)
* hyphen (-), -- operator: Increment Ops. (line 48)
@@ -33019,7 +33034,7 @@ Index
* installing gawk: Installation. (line 6)
* instruction tracing, in debugger: Debugger Info. (line 89)
* int: Numeric Functions. (line 38)
-* INT signal (MS-Windows): Profiling. (line 214)
+* INT signal (MS-Windows): Profiling. (line 213)
* integer array indices: Numeric Array Subscripts.
(line 31)
* integers, arbitrary precision: Arbitrary Precision Integers.
@@ -33075,7 +33090,7 @@ Index
* Kernighan, Brian <9>: Acknowledgments. (line 78)
* Kernighan, Brian <10>: Conventions. (line 38)
* Kernighan, Brian: History. (line 17)
-* kill command, dynamic profiling: Profiling. (line 188)
+* kill command, dynamic profiling: Profiling. (line 187)
* Knights, jedi: Undocumented. (line 6)
* Kwok, Conrad: Contributors. (line 34)
* l debugger command (alias for list): Miscellaneous Debugger Commands.
@@ -33582,7 +33597,7 @@ Index
* PROCINFO, values of sorted_in: Controlling Scanning.
(line 26)
* profiling awk programs: Profiling. (line 6)
-* profiling awk programs, dynamically: Profiling. (line 179)
+* profiling awk programs, dynamically: Profiling. (line 178)
* program identifiers: Auto-set. (line 155)
* program, definition of: Getting Started. (line 21)
* programming conventions, --non-decimal-data option: Nondecimal Data.
@@ -33618,7 +33633,7 @@ Index
* QuikTrim Awk: Other Versions. (line 135)
* quit debugger command: Miscellaneous Debugger Commands.
(line 99)
-* QUIT signal (MS-Windows): Profiling. (line 214)
+* QUIT signal (MS-Windows): Profiling. (line 213)
* quoting in gawk command lines: Long. (line 26)
* quoting in gawk command lines, tricks for: Quoting. (line 91)
* quoting, for small awk programs: Comments. (line 27)
@@ -33899,15 +33914,15 @@ Index
(line 57)
* sidebar, Using close()'s Return Value: Close Files And Pipes.
(line 130)
-* SIGHUP signal, for dynamic profiling: Profiling. (line 211)
-* SIGINT signal (MS-Windows): Profiling. (line 214)
-* signals, HUP/SIGHUP, for profiling: Profiling. (line 211)
-* signals, INT/SIGINT (MS-Windows): Profiling. (line 214)
-* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 214)
-* signals, USR1/SIGUSR1, for profiling: Profiling. (line 188)
+* SIGHUP signal, for dynamic profiling: Profiling. (line 210)
+* SIGINT signal (MS-Windows): Profiling. (line 213)
+* signals, HUP/SIGHUP, for profiling: Profiling. (line 210)
+* signals, INT/SIGINT (MS-Windows): Profiling. (line 213)
+* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 213)
+* signals, USR1/SIGUSR1, for profiling: Profiling. (line 187)
* signature program: Signature Program. (line 6)
-* SIGQUIT signal (MS-Windows): Profiling. (line 214)
-* SIGUSR1 signal, for dynamic profiling: Profiling. (line 188)
+* SIGQUIT signal (MS-Windows): Profiling. (line 213)
+* SIGUSR1 signal, for dynamic profiling: Profiling. (line 187)
* silent debugger command: Debugger Execution Control.
(line 10)
* sin: Numeric Functions. (line 91)
@@ -34181,7 +34196,7 @@ Index
* user-modifiable variables: User-modified. (line 6)
* users, information about, printing: Id Program. (line 6)
* users, information about, retrieving: Passwd Functions. (line 16)
-* USR1 signal, for dynamic profiling: Profiling. (line 188)
+* USR1 signal, for dynamic profiling: Profiling. (line 187)
* values, numeric: Basic Data Typing. (line 13)
* values, string: Basic Data Typing. (line 13)
* variable assignments and input files: Other Arguments. (line 26)
@@ -34655,210 +34670,210 @@ Ref: Two-way I/O-Footnote-1792709
Ref: Two-way I/O-Footnote-2792895
Node: TCP/IP Networking792977
Node: Profiling795849
-Node: Advanced Features Summary803402
-Node: Internationalization805335
-Node: I18N and L10N806815
-Node: Explaining gettext807501
-Ref: Explaining gettext-Footnote-1812530
-Ref: Explaining gettext-Footnote-2812714
-Node: Programmer i18n812879
-Ref: Programmer i18n-Footnote-1817745
-Node: Translator i18n817794
-Node: String Extraction818588
-Ref: String Extraction-Footnote-1819719
-Node: Printf Ordering819805
-Ref: Printf Ordering-Footnote-1822591
-Node: I18N Portability822655
-Ref: I18N Portability-Footnote-1825104
-Node: I18N Example825167
-Ref: I18N Example-Footnote-1827967
-Node: Gawk I18N828039
-Node: I18N Summary828677
-Node: Debugger830016
-Node: Debugging831038
-Node: Debugging Concepts831479
-Node: Debugging Terms833336
-Node: Awk Debugging835911
-Node: Sample Debugging Session836803
-Node: Debugger Invocation837323
-Node: Finding The Bug838707
-Node: List of Debugger Commands845182
-Node: Breakpoint Control846514
-Node: Debugger Execution Control850206
-Node: Viewing And Changing Data853570
-Node: Execution Stack856935
-Node: Debugger Info858573
-Node: Miscellaneous Debugger Commands862590
-Node: Readline Support867782
-Node: Limitations868674
-Node: Debugging Summary870771
-Node: Arbitrary Precision Arithmetic871939
-Node: Computer Arithmetic873355
-Ref: table-numeric-ranges876956
-Ref: Computer Arithmetic-Footnote-1877815
-Node: Math Definitions877872
-Ref: table-ieee-formats881159
-Ref: Math Definitions-Footnote-1881763
-Node: MPFR features881868
-Node: FP Math Caution883539
-Ref: FP Math Caution-Footnote-1884589
-Node: Inexactness of computations884958
-Node: Inexact representation885906
-Node: Comparing FP Values887261
-Node: Errors accumulate888334
-Node: Getting Accuracy889767
-Node: Try To Round892426
-Node: Setting precision893325
-Ref: table-predefined-precision-strings894009
-Node: Setting the rounding mode895803
-Ref: table-gawk-rounding-modes896167
-Ref: Setting the rounding mode-Footnote-1899621
-Node: Arbitrary Precision Integers899800
-Ref: Arbitrary Precision Integers-Footnote-1904704
-Node: POSIX Floating Point Problems904853
-Ref: POSIX Floating Point Problems-Footnote-1908729
-Node: Floating point summary908767
-Node: Dynamic Extensions910959
-Node: Extension Intro912511
-Node: Plugin License913777
-Node: Extension Mechanism Outline914574
-Ref: figure-load-extension915002
-Ref: figure-register-new-function916482
-Ref: figure-call-new-function917486
-Node: Extension API Description919472
-Node: Extension API Functions Introduction920922
-Node: General Data Types925758
-Ref: General Data Types-Footnote-1931445
-Node: Memory Allocation Functions931744
-Ref: Memory Allocation Functions-Footnote-1934574
-Node: Constructor Functions934670
-Node: Registration Functions936404
-Node: Extension Functions937089
-Node: Exit Callback Functions939385
-Node: Extension Version String940633
-Node: Input Parsers941283
-Node: Output Wrappers951098
-Node: Two-way processors955614
-Node: Printing Messages957818
-Ref: Printing Messages-Footnote-1958895
-Node: Updating `ERRNO'959047
-Node: Requesting Values959787
-Ref: table-value-types-returned960515
-Node: Accessing Parameters961473
-Node: Symbol Table Access962704
-Node: Symbol table by name963218
-Node: Symbol table by cookie965198
-Ref: Symbol table by cookie-Footnote-1969337
-Node: Cached values969400
-Ref: Cached values-Footnote-1972904
-Node: Array Manipulation972995
-Ref: Array Manipulation-Footnote-1974093
-Node: Array Data Types974132
-Ref: Array Data Types-Footnote-1976789
-Node: Array Functions976881
-Node: Flattening Arrays980735
-Node: Creating Arrays987622
-Node: Extension API Variables992389
-Node: Extension Versioning993025
-Node: Extension API Informational Variables994926
-Node: Extension API Boilerplate996014
-Node: Finding Extensions999830
-Node: Extension Example1000390
-Node: Internal File Description1001162
-Node: Internal File Ops1005229
-Ref: Internal File Ops-Footnote-11016887
-Node: Using Internal File Ops1017027
-Ref: Using Internal File Ops-Footnote-11019410
-Node: Extension Samples1019683
-Node: Extension Sample File Functions1021207
-Node: Extension Sample Fnmatch1028809
-Node: Extension Sample Fork1030291
-Node: Extension Sample Inplace1031504
-Node: Extension Sample Ord1033179
-Node: Extension Sample Readdir1034015
-Ref: table-readdir-file-types1034871
-Node: Extension Sample Revout1035682
-Node: Extension Sample Rev2way1036273
-Node: Extension Sample Read write array1037014
-Node: Extension Sample Readfile1038953
-Node: Extension Sample Time1040048
-Node: Extension Sample API Tests1041397
-Node: gawkextlib1041888
-Node: Extension summary1044538
-Node: Extension Exercises1048220
-Node: Language History1048942
-Node: V7/SVR3.11050599
-Node: SVR41052780
-Node: POSIX1054225
-Node: BTL1055614
-Node: POSIX/GNU1056348
-Node: Feature History1061977
-Node: Common Extensions1075068
-Node: Ranges and Locales1076392
-Ref: Ranges and Locales-Footnote-11081031
-Ref: Ranges and Locales-Footnote-21081058
-Ref: Ranges and Locales-Footnote-31081292
-Node: Contributors1081513
-Node: History summary1087053
-Node: Installation1088422
-Node: Gawk Distribution1089378
-Node: Getting1089862
-Node: Extracting1090686
-Node: Distribution contents1092328
-Node: Unix Installation1098098
-Node: Quick Installation1098715
-Node: Additional Configuration Options1101146
-Node: Configuration Philosophy1102886
-Node: Non-Unix Installation1105237
-Node: PC Installation1105695
-Node: PC Binary Installation1107021
-Node: PC Compiling1108869
-Ref: PC Compiling-Footnote-11111890
-Node: PC Testing1111995
-Node: PC Using1113171
-Node: Cygwin1117286
-Node: MSYS1118109
-Node: VMS Installation1118607
-Node: VMS Compilation1119399
-Ref: VMS Compilation-Footnote-11120621
-Node: VMS Dynamic Extensions1120679
-Node: VMS Installation Details1122363
-Node: VMS Running1124615
-Node: VMS GNV1127456
-Node: VMS Old Gawk1128190
-Node: Bugs1128660
-Node: Other Versions1132564
-Node: Installation summary1138777
-Node: Notes1139833
-Node: Compatibility Mode1140698
-Node: Additions1141480
-Node: Accessing The Source1142405
-Node: Adding Code1143841
-Node: New Ports1150013
-Node: Derived Files1154495
-Ref: Derived Files-Footnote-11159970
-Ref: Derived Files-Footnote-21160004
-Ref: Derived Files-Footnote-31160600
-Node: Future Extensions1160714
-Node: Implementation Limitations1161320
-Node: Extension Design1162568
-Node: Old Extension Problems1163722
-Ref: Old Extension Problems-Footnote-11165239
-Node: Extension New Mechanism Goals1165296
-Ref: Extension New Mechanism Goals-Footnote-11168656
-Node: Extension Other Design Decisions1168845
-Node: Extension Future Growth1170953
-Node: Old Extension Mechanism1171789
-Node: Notes summary1173551
-Node: Basic Concepts1174737
-Node: Basic High Level1175418
-Ref: figure-general-flow1175690
-Ref: figure-process-flow1176289
-Ref: Basic High Level-Footnote-11179518
-Node: Basic Data Typing1179703
-Node: Glossary1183031
-Node: Copying1208189
-Node: GNU Free Documentation License1245745
-Node: Index1270881
+Node: Advanced Features Summary804123
+Node: Internationalization806056
+Node: I18N and L10N807536
+Node: Explaining gettext808222
+Ref: Explaining gettext-Footnote-1813251
+Ref: Explaining gettext-Footnote-2813435
+Node: Programmer i18n813600
+Ref: Programmer i18n-Footnote-1818466
+Node: Translator i18n818515
+Node: String Extraction819309
+Ref: String Extraction-Footnote-1820440
+Node: Printf Ordering820526
+Ref: Printf Ordering-Footnote-1823312
+Node: I18N Portability823376
+Ref: I18N Portability-Footnote-1825825
+Node: I18N Example825888
+Ref: I18N Example-Footnote-1828688
+Node: Gawk I18N828760
+Node: I18N Summary829398
+Node: Debugger830737
+Node: Debugging831759
+Node: Debugging Concepts832200
+Node: Debugging Terms834057
+Node: Awk Debugging836632
+Node: Sample Debugging Session837524
+Node: Debugger Invocation838044
+Node: Finding The Bug839428
+Node: List of Debugger Commands845903
+Node: Breakpoint Control847235
+Node: Debugger Execution Control850927
+Node: Viewing And Changing Data854291
+Node: Execution Stack857656
+Node: Debugger Info859294
+Node: Miscellaneous Debugger Commands863311
+Node: Readline Support868503
+Node: Limitations869395
+Node: Debugging Summary871492
+Node: Arbitrary Precision Arithmetic872660
+Node: Computer Arithmetic874076
+Ref: table-numeric-ranges877677
+Ref: Computer Arithmetic-Footnote-1878536
+Node: Math Definitions878593
+Ref: table-ieee-formats881880
+Ref: Math Definitions-Footnote-1882484
+Node: MPFR features882589
+Node: FP Math Caution884260
+Ref: FP Math Caution-Footnote-1885310
+Node: Inexactness of computations885679
+Node: Inexact representation886627
+Node: Comparing FP Values887982
+Node: Errors accumulate889055
+Node: Getting Accuracy890488
+Node: Try To Round893147
+Node: Setting precision894046
+Ref: table-predefined-precision-strings894730
+Node: Setting the rounding mode896524
+Ref: table-gawk-rounding-modes896888
+Ref: Setting the rounding mode-Footnote-1900342
+Node: Arbitrary Precision Integers900521
+Ref: Arbitrary Precision Integers-Footnote-1905425
+Node: POSIX Floating Point Problems905574
+Ref: POSIX Floating Point Problems-Footnote-1909450
+Node: Floating point summary909488
+Node: Dynamic Extensions911680
+Node: Extension Intro913232
+Node: Plugin License914498
+Node: Extension Mechanism Outline915295
+Ref: figure-load-extension915723
+Ref: figure-register-new-function917203
+Ref: figure-call-new-function918207
+Node: Extension API Description920193
+Node: Extension API Functions Introduction921643
+Node: General Data Types926479
+Ref: General Data Types-Footnote-1932166
+Node: Memory Allocation Functions932465
+Ref: Memory Allocation Functions-Footnote-1935295
+Node: Constructor Functions935391
+Node: Registration Functions937125
+Node: Extension Functions937810
+Node: Exit Callback Functions940106
+Node: Extension Version String941354
+Node: Input Parsers942004
+Node: Output Wrappers951819
+Node: Two-way processors956335
+Node: Printing Messages958539
+Ref: Printing Messages-Footnote-1959616
+Node: Updating `ERRNO'959768
+Node: Requesting Values960508
+Ref: table-value-types-returned961236
+Node: Accessing Parameters962194
+Node: Symbol Table Access963425
+Node: Symbol table by name963939
+Node: Symbol table by cookie965919
+Ref: Symbol table by cookie-Footnote-1970058
+Node: Cached values970121
+Ref: Cached values-Footnote-1973625
+Node: Array Manipulation973716
+Ref: Array Manipulation-Footnote-1974814
+Node: Array Data Types974853
+Ref: Array Data Types-Footnote-1977510
+Node: Array Functions977602
+Node: Flattening Arrays981456
+Node: Creating Arrays988343
+Node: Extension API Variables993110
+Node: Extension Versioning993746
+Node: Extension API Informational Variables995647
+Node: Extension API Boilerplate996735
+Node: Finding Extensions1000551
+Node: Extension Example1001111
+Node: Internal File Description1001883
+Node: Internal File Ops1005950
+Ref: Internal File Ops-Footnote-11017608
+Node: Using Internal File Ops1017748
+Ref: Using Internal File Ops-Footnote-11020131
+Node: Extension Samples1020404
+Node: Extension Sample File Functions1021928
+Node: Extension Sample Fnmatch1029530
+Node: Extension Sample Fork1031012
+Node: Extension Sample Inplace1032225
+Node: Extension Sample Ord1033900
+Node: Extension Sample Readdir1034736
+Ref: table-readdir-file-types1035592
+Node: Extension Sample Revout1036403
+Node: Extension Sample Rev2way1036994
+Node: Extension Sample Read write array1037735
+Node: Extension Sample Readfile1039674
+Node: Extension Sample Time1040769
+Node: Extension Sample API Tests1042118
+Node: gawkextlib1042609
+Node: Extension summary1045259
+Node: Extension Exercises1048941
+Node: Language History1049663
+Node: V7/SVR3.11051320
+Node: SVR41053501
+Node: POSIX1054946
+Node: BTL1056335
+Node: POSIX/GNU1057069
+Node: Feature History1062698
+Node: Common Extensions1075789
+Node: Ranges and Locales1077113
+Ref: Ranges and Locales-Footnote-11081752
+Ref: Ranges and Locales-Footnote-21081779
+Ref: Ranges and Locales-Footnote-31082013
+Node: Contributors1082234
+Node: History summary1087774
+Node: Installation1089143
+Node: Gawk Distribution1090099
+Node: Getting1090583
+Node: Extracting1091407
+Node: Distribution contents1093049
+Node: Unix Installation1098819
+Node: Quick Installation1099436
+Node: Additional Configuration Options1101867
+Node: Configuration Philosophy1103607
+Node: Non-Unix Installation1105958
+Node: PC Installation1106416
+Node: PC Binary Installation1107742
+Node: PC Compiling1109590
+Ref: PC Compiling-Footnote-11112611
+Node: PC Testing1112716
+Node: PC Using1113892
+Node: Cygwin1118007
+Node: MSYS1118830
+Node: VMS Installation1119328
+Node: VMS Compilation1120120
+Ref: VMS Compilation-Footnote-11121342
+Node: VMS Dynamic Extensions1121400
+Node: VMS Installation Details1123084
+Node: VMS Running1125336
+Node: VMS GNV1128177
+Node: VMS Old Gawk1128911
+Node: Bugs1129381
+Node: Other Versions1133285
+Node: Installation summary1139498
+Node: Notes1140554
+Node: Compatibility Mode1141419
+Node: Additions1142201
+Node: Accessing The Source1143126
+Node: Adding Code1144562
+Node: New Ports1150734
+Node: Derived Files1155216
+Ref: Derived Files-Footnote-11160691
+Ref: Derived Files-Footnote-21160725
+Ref: Derived Files-Footnote-31161321
+Node: Future Extensions1161435
+Node: Implementation Limitations1162041
+Node: Extension Design1163289
+Node: Old Extension Problems1164443
+Ref: Old Extension Problems-Footnote-11165960
+Node: Extension New Mechanism Goals1166017
+Ref: Extension New Mechanism Goals-Footnote-11169377
+Node: Extension Other Design Decisions1169566
+Node: Extension Future Growth1171674
+Node: Old Extension Mechanism1172510
+Node: Notes summary1174272
+Node: Basic Concepts1175458
+Node: Basic High Level1176139
+Ref: figure-general-flow1176411
+Ref: figure-process-flow1177010
+Ref: Basic High Level-Footnote-11180239
+Node: Basic Data Typing1180424
+Node: Glossary1183752
+Node: Copying1208910
+Node: GNU Free Documentation License1246466
+Node: Index1271602
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 20087fa..0f2b298 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -27812,8 +27812,7 @@ The profiled version of your program may not look
exactly like what you
typed when you wrote it. This is because @command{gawk} creates the
profiled version by ``pretty printing'' its internal representation of
the program. The advantage to this is that @command{gawk} can produce
-a standard representation. The disadvantage is that all source-code
-comments are lost.
+a standard representation.
Also, things such as:
@example
@@ -27910,6 +27909,23 @@ When called this way, @command{gawk} ``pretty prints''
the program into
Once upon a time, the @option{--pretty-print} option would also run
your program. This is is no longer the case.
@end quotation
+
+There is a significant difference between the output created when
+profiling, and that created when pretty-printing. Pretty-printed output
+preserves the original comments that were in the program, although their
+placement may not correspond exactly to their original locations in the
+source code.
+
+However, as a deliberate design decision, profiling output @emph{omits}
+the original program's comments. This allows you to focus on the
+execution count data and helps you avoid the temptation to use the
+profiler for pretty-printing.
+
+Additionally, pretty-printed output does not have the leading indentation
+that the profiling output does. This makes it easy to pretty-print your
+code once development is completed, and then use the result as the final
+version of your program.
+
@c ENDOFRANGE awkp
@c ENDOFRANGE proawk
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=0485d6bfe2417a7640ef95c9de6f48e1f35003fd
commit 0485d6bfe2417a7640ef95c9de6f48e1f35003fd
Merge: 7504a8f 2a8c128
Author: Arnold D. Robbins <address@hidden>
Date: Mon Oct 13 11:27:13 2014 +0300
Merge branch 'master' into cmake
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 254 +
NEWS | 18 +
README | 3 -
TODO | 27 +-
awk.h | 19 +-
awkgram.c | 1057 ++--
awkgram.y | 340 +-
awklib/eg/lib/ctime.awk | 3 +-
awklib/eg/lib/div.awk | 2 +-
awklib/eg/lib/ftrans.awk | 2 +-
awklib/eg/lib/getopt.awk | 3 +-
awklib/eg/lib/gettime.awk | 2 +-
awklib/eg/lib/groupawk.in | 6 +-
awklib/eg/lib/noassign.awk | 2 +-
awklib/eg/lib/processarray.awk | 12 +
awklib/eg/lib/quicksort.awk | 2 +-
awklib/eg/lib/readable.awk | 2 +-
awklib/eg/lib/shellquote.awk | 22 +
awklib/eg/lib/strtonum.awk | 9 +-
awklib/eg/misc/arraymax.awk | 10 +-
awklib/eg/misc/findpat.awk | 13 +-
awklib/eg/prog/alarm.awk | 3 +-
awklib/eg/prog/cut.awk | 11 +-
awklib/eg/prog/egrep.awk | 10 +-
awklib/eg/prog/extract.awk | 11 +-
awklib/eg/prog/id.awk | 25 +-
awklib/eg/prog/labels.awk | 3 +-
awklib/eg/prog/pi.awk | 18 +
awklib/eg/prog/split.awk | 5 +-
awklib/eg/prog/tee.awk | 6 +-
awklib/eg/prog/uniq.awk | 10 +-
builtin.c | 15 +-
command.c | 8 +-
command.y | 8 +-
configh.in | 7 +-
configure | 23 +-
configure.ac | 15 +-
debug.c | 1 +
dfa.c | 162 +-
doc/ChangeLog | 155 +
doc/gawk.1 | 13 +-
doc/gawk.info | 5672 +++++++++--------
doc/gawk.texi | 4086 +++++++------
doc/gawktexi.in | 4177 +++++++------
doc/using-git.texi | 321 +-
eval.c | 3 +
ext.c | 30 +-
extension/ChangeLog | 10 +
extension/filefuncs.c | 4 +-
extension/inplace.c | 5 +-
extension/testext.c | 6 +
gawkapi.h | 12 +-
helpers/ChangeLog | 4 +
helpers/chlistref.awk | 31 +
interpret.h | 44 +-
io.c | 17 +-
main.c | 29 +-
node.c | 4 +-
pc/ChangeLog | 4 +
pc/Makefile.tst | 79 +-
pc/config.h | 6 +
po/sv.gmo | Bin 80916 -> 80917 bytes
po/sv.po | 31 +-
profile.c | 138 +-
regcomp.c | 38 +-
regex.h | 62 +-
regex_internal.c | 9 +-
replace.c | 2 +-
symbol.c | 27 +-
test/ChangeLog | 60 +
test/Makefile.am | 27 +-
test/Makefile.in | 36 +-
test/Maketests | 10 +-
test/filefuncs.awk | 2 +-
test/functab4.awk | 26 +-
test/functab4.ok | 7 +-
test/genpot.awk | 1 +
test/genpot.ok | 5 +
test/id.ok | 81 +-
test/indirectcall2.awk | 11 +
test/indirectcall2.ok | 4 +
test/profile2.ok | 6 +-
test/profile3.ok | 2 +-
test/profile4.ok | 18 +-
test/profile5.ok |13313 ++++++++++++++++++++++------------------
test/testext.ok | 1 +
86 files changed, 17606 insertions(+), 13172 deletions(-)
create mode 100644 awklib/eg/lib/processarray.awk
create mode 100644 awklib/eg/lib/shellquote.awk
create mode 100644 awklib/eg/prog/pi.awk
create mode 100644 helpers/chlistref.awk
create mode 100644 test/genpot.awk
create mode 100644 test/genpot.ok
create mode 100644 test/indirectcall2.awk
create mode 100644 test/indirectcall2.ok
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, cmake, updated. gawk-4.1.0-885-g14da33f,
Arnold Robbins <=