Skip to content

Commit

Permalink
update license, changes file and README
Browse files Browse the repository at this point in the history
  • Loading branch information
eliben committed Dec 25, 2012
1 parent 97b1ee0 commit 9335251
Show file tree
Hide file tree
Showing 5 changed files with 14 additions and 6 deletions.
6 changes: 6 additions & 0 deletions CHANGES
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
+ Version 2.09 (??)

- pycparser now carries its PLY dependency along. The pycparser/ply directory
contains the source of PLY for the currently supported version. This makes
distribution and testing easier.

+ Version 2.08 (10.08.2012)

- Issue 73: initial support for #pragma directives. Consume them without
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Copyright (c) 2011, Eli Bendersky
Copyright (c) 2012, Eli Bendersky
All rights reserved.

Redistribution and use in source and binary forms, with or without modification,
Expand Down
7 changes: 4 additions & 3 deletions README.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.8.1: http://docutils.sourceforge.net/" />
<title>pycparser v2.08</title>
<title>pycparser v2.09</title>
<meta name="author" content="Eli Bendersky" />
<style type="text/css">

Expand Down Expand Up @@ -315,8 +315,8 @@
</style>
</head>
<body>
<div class="document" id="pycparser-v2-08">
<h1 class="title">pycparser v2.08</h1>
<div class="document" id="pycparser-v2-09">
<h1 class="title">pycparser v2.09</h1>
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
Expand Down Expand Up @@ -427,6 +427,7 @@ <h2>3.1&nbsp;&nbsp;&nbsp;Interaction with the C preprocessor</h2>
<div class="section" id="what-about-the-standard-c-library-headers">
<h2>3.2&nbsp;&nbsp;&nbsp;What about the standard C library headers?</h2>
<p>C code almost always includes various header files from the standard C library, like <tt class="docutils literal">stdio.h</tt>. While, with some effort, <tt class="docutils literal">pycparser</tt> can be made to parse the standard headers from any C compiler, it's much simpler to use the provided &quot;fake&quot; standard includes in <tt class="docutils literal">utils/fake_libc_include</tt>. These are standard C header files that contain only the bare necessities to allow valid parsing of the files that use them. As a bonus, since they're minimal, it can significantly improve the performance of parsing large C files.</p>
<p>The key point to understand here is that <tt class="docutils literal">pycparser</tt> doesn't really care aabout the semantics of types. It only needs to know whether some token encountered in the source is a previously defined type. This is essential in order to be able to parse C correctly.</p>
<p>See the <tt class="docutils literal">using_cpp_libc.py</tt> example for more details.</p>
</div>
<div class="section" id="basic-usage">
Expand Down
4 changes: 3 additions & 1 deletion README.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
===============
pycparser v2.08
pycparser v2.09
===============

:Author: `Eli Bendersky <http://eli.thegreenplace.net>`_
Expand Down Expand Up @@ -98,6 +98,8 @@ What about the standard C library headers?

C code almost always includes various header files from the standard C library, like ``stdio.h``. While, with some effort, ``pycparser`` can be made to parse the standard headers from any C compiler, it's much simpler to use the provided "fake" standard includes in ``utils/fake_libc_include``. These are standard C header files that contain only the bare necessities to allow valid parsing of the files that use them. As a bonus, since they're minimal, it can significantly improve the performance of parsing large C files.

The key point to understand here is that ``pycparser`` doesn't really care aabout the semantics of types. It only needs to know whether some token encountered in the source is a previously defined type. This is essential in order to be able to parse C correctly.

See the ``using_cpp_libc.py`` example for more details.

Basic usage
Expand Down
1 change: 0 additions & 1 deletion TODO.txt
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
Todo
----

- Write a FAQ about using fake headers
- Carry PLY around instead of requiring to install it
- close issue 31 and open new one

Expand Down

0 comments on commit 9335251

Please sign in to comment.