Permalink
Browse files

doc: download links changed again!

  • Loading branch information...
HardySimpson committed Apr 1, 2012
1 parent 4153135 commit 924b15f2dd2065d0c433287264b8de649364bac3
View
@@ -1,2 +0,0 @@
-0.9
- * initial release
View
@@ -9,4 +9,10 @@ endif
pkgconfigdir = $(libdir)/pkgconfig
pkgconfig_DATA = zlog.pc
-EXTRA_DIST = autogen.sh zlog.pc.in
+EXTRA_DIST = \
+ autogen.sh \
+ zlog.pc.in \
+ doc/UsersGuide-CN.pdf \
+ doc/UsersGuide-EN.pdf \
+ doc/GettingStart-CN.txt \
+ doc/GettingStart-EN.txt
View
0 NEWS
No changes.
View
1 README
View
@@ -1,33 +0,0 @@
-# What is zlog? #
-
-*zlog* is a high efficent, thread safe, flexsible, clear model, pure c logging library
-
-Actually, in the c world there is NO good logging library for application like logback in java or log4cxx in c++. printf can work, but can not be easily redirected or reformat, syslog is slow and is designed for system use.
-
-So I write *zlog*.
-
-*zlog* has feartures below:
-
- * syslog style configure file, easy for understand and use
- * range-category model, which is more flexible and more clear than hierarchy model of log4j
- * multiple output, include static file path, dynamic file path, stdout, stderr, syslog
- * runtime refreash configure to change output flow or output format, just need to call one function -- zlog_update()
- * high efficieny, on my laptop, record 720'000 log per second, about 200 times faster than syslog(3) with rsyslogd
- * user can define his own log level without change and rebuild library[sec:Define-new-level]
- * safely rotate log file by size when multiple process or multiple threads write to one same log file
- * accurate to microseconds
- * MDC, a log4j style key-value map, expand user defined field in dynamic log file path or log format, is also useful in multi-thread programming
- * self debugable, can output zlog's self debug and error log at runtime
- * Not depend on any other 3rd party library, just base on POSIX system.
-
-Links:
-
-[Users Guide(PDF)](https://github.com/HardySimpson/zlog/raw/master/download/ZlogUsersGuide-EN-0.9rc1.pdf)
-
-[使用攻略(PDF)](https://github.com/HardySimpson/zlog/raw/master/download/ZlogUsersGuide-CN-0.9rc1.pdf)
-
-[Author's Blog](http://my.oschina.net/HardySimpson/blog)
-
-[Author's Email](mailto:HardySimpson1984@gmail.com)
-
-[zlog中文交流地点,开源中国](http://www.oschina.net/p/zlog)
View
@@ -1,11 +1,17 @@
-zlog是个概念清晰的日志函数库,在效率、功能、安全性上大大超过了log4c,并且是用c写成的,具有比较好的通用性
+0. zlog是什么?
+
+zlog是一个高性能、线程安全、灵活、概念清晰的纯C日志函数库。
+
+ 事实上,在C的世界里面没有特别好的日志函数库(就像JAVA里面的的log4j,或者C++的log4cxx)。C程序员都喜欢用自己的轮子。printf就是个挺好的轮子,但没办法通过配置改变日志的格式或者输出文件。syslog是个系统级别的轮子,不过速度慢,而且功能比较单调。
+ 所以我写了zlog。
+ zlog在效率、功能、安全性上大大超过了log4c,并且是用c写成的,具有比较好的通用性。
1.安装
-下载 https://github.com/HardySimpson/zlog/raw/master/download/zlog-0.9.0.tar.gz
+下载 https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz
# 解压, 安装
-$ tar -zxvf zlog-0.9.0.tar.gz
+$ tar -zxvf zlog-latest-stable.tar.gz
$ cd zlog-0.9.0/
$ ./configure --enable-test # 把测试程序和案例也编译下,反正不安装
$ make
@@ -41,27 +47,27 @@ $ vi test_hello.c
int main(int argc, char** argv)
{
- int rc;
- zlog_category_t *c;
+ int rc;
+ zlog_category_t *c;
- rc = zlog_init("/etc/zlog.conf");
- if (rc) {
- printf("init failed\n");
- return -1;
- }
+ rc = zlog_init("/etc/zlog.conf");
+ if (rc) {
+ printf("init failed\n");
+ return -1;
+ }
- c = zlog_get_category("my_cat");
- if (!my_cat) {
- printf("get cat fail\n");
- zlog_fini();
- return -2;
- }
+ c = zlog_get_category("my_cat");
+ if (!my_cat) {
+ printf("get cat fail\n");
+ zlog_fini();
+ return -2;
+ }
- ZLOG_INFO(c, "hello, zlog");
+ ZLOG_INFO(c, "hello, zlog");
- zlog_fini();
+ zlog_fini();
- return 0;
+ return 0;
}
4.编译、然后运行!
@@ -72,25 +78,26 @@ $ ./test_hello
hello, zlog
5.高级使用
-• syslog风格的配置文件,易学易用
-• 可以灵活配置日志输出的格式,类似于log4j的pattern layout
-• 纲目分类模型,比log4j系列的继承模型更加清晰
-• 多种输出,包括动态文件、静态文件、stdout、stderr、syslog
-• 可以在运行时动态刷新配置,只需要调用函数zlog_update()
-• 高性能,在我的笔记本上达到72'000条日志每秒, 大概是syslog(3)配合rsyslogd的200倍速度
-• 用户可以自定义等级,无需改变库代码
-• 多线程和多进程写同一个日志的情况下,安全转档(转档就是把太大的日志重命名)
-• 可以精确到微秒
-• 如果一个程序默认只用一个分类输出,zlog提供了简单的调用包装dzlog
-• MDC,一个log4j风格的键-值对的表,可以扩展用户自定义的字段
-• 自诊断,可以在运行时输出zlog自己的日志和配置状态
-• 不依赖其他库,只要是个POSIX系统就成
-
-详见
-相关链接:
-
-软件下载:https://github.com/HardySimpson/zlog/raw/master/download/zlog-0.9.0.tar.gz
-详细使用攻略:https://github.com/HardySimpson/zlog/raw/master/download/ZlogUsersGuide-CN-0.9rc1.pdf
-主页:https://github.com/HardySimpson/zlog
+ * syslog风格的配置文件,易学易用
+ * 可以灵活配置日志输出的格式,类似于log4j的pattern layout
+ * 纲目分类模型,比log4j系列的继承模型更加清晰
+ * 多种输出,包括动态文件、静态文件、stdout、stderr、syslog
+ * 可以在运行时动态刷新配置,只需要调用函数zlog_update()
+ * 高性能,在我的笔记本上达到72'000条日志每秒, 大概是syslog(3)配合rsyslogd的200倍速度
+ * 用户可以自定义等级,无需改变库代码
+ * 多线程和多进程写同一个日志的情况下,安全转档(转档就是把太大的日志重命名)
+ * 可以精确到微秒
+ * 如果一个程序默认只用一个分类输出,zlog提供了简单的调用包装dzlog
+ * MDC,一个log4j风格的键-值对的表,可以扩展用户自定义的字段
+ * 自诊断,可以在运行时输出zlog自己的日志和配置状态
+ * 不依赖其他库,只要是个POSIX系统就成
+
+6.相关链接
+软件下载:https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz
+上手指南:zlog-latest-stable.tar.gz包内doc目录下 GettingStart-CN.txt GettingStart-EN.txt
+使用攻略:zlog-latest-stable.tar.gz包内doc目录下 UsersGuide-CN.pdf UsersGuide-EN.pdf
+源代码:git@github.com:HardySimpson/zlog.git
+英文主页:http://hardysimpson.github.com/zlog
+中文主页:http://www.oschina.net/p/zlog
作者博客:http://my.oschina.net/HardySimpson/blog
邮箱:HardySimpson1984@gmail.com
View
@@ -1,17 +1,23 @@
-zlog is a clear-modeled pure c logging library. It is faster, safer and more powerful than log4c. So it can be widely used.
+0. What is zlog?
+
+zlog is a high efficent, thread safe, flexsible, clear model, pure c logging library.
+
+ Actually, in the c world there is NO good logging library for application like logback in java or log4cxx in c++. printf can work, but can not be easily redirected or reformat, syslog is slow and is designed for system use.
+ So I write zlog.
+ It is faster, safer and more powerful than log4c. So it can be widely used.
1. Install
-Download https://github.com/HardySimpson/zlog/raw/master/download/zlog-0.9.0.tar.gz
+Download https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz
-# uncompress, install
-$ tar -zxvf zlog-0.9.0.tar.gz
+uncompress, install
+$ tar -zxvf zlog-latest-stable.tar.gz
$ cd zlog-0.9.0/
$ ./configure --enable-test # complie test program
$ make
$ sudo make install
-# default install in /usr/local/, include libzlog.so and zlog.h
+default install in /usr/local/, include libzlog.so and zlog.h
2. Introduce configure file
@@ -74,25 +80,27 @@ $ ./test_hello
hello, zlog
5. Advance Using
- syslog style configure file, easy for understand and use
- log format Customization, like pattern layout in log4j
- range-category model, which is more flexible and more clear than hierarchy model of log4j
- multiple output, include static file path, dynamic file path, stdout, stderr, syslog
- runtime refreash configure to change output flow or output format, just need to call one function -- zlog_update()
- high efficieny, on my laptop, record 720'000 log per second, about 200 times faster than syslog(3) with rsyslogd
- user can define his own log level without change and rebuild library
- safely rotate log file by size when multiple process or multiple threads write to one same log file
- accurate to microseconds
- dzlog, a default category log API for easy use
- MDC, a log4j style key-value map, expand user defined field in dynamic log file path or log format, is also useful in multi-thread programming
- self debugable, can output zlog's self debug&error log at runtime
- Not depend on any other 3rd party library, just base on POSIX system.
+ * syslog style configure file, easy for understand and use
+ * log format Customization, like pattern layout in log4j
+ * range-category model, which is more flexible and more clear than hierarchy model of log4j
+ * multiple output, include static file path, dynamic file path, stdout, stderr, syslog
+ * runtime refreash configure to change output flow or output format, just need to call one function -- zlog_update()
+ * high efficieny, on my laptop, record 720'000 log per second, about 200 times faster than syslog(3) with rsyslogd
+ * user can define his own log level without change and rebuild library
+ * safely rotate log file by size when multiple process or multiple threads write to one same log file
+ * accurate to microseconds
+ * dzlog, a default category log API for easy use
+ * MDC, a log4j style key-value map, expand user defined field in dynamic log file path or log format, is also useful in multi-thread programming
+ * self debugable, can output zlog's self debug&error log at runtime
+ * Not depend on any other 3rd party library, just base on POSIX system.
6. Links:
-Download: https://github.com/HardySimpson/zlog/zipball/master
-UsersGuide:https://github.com/HardySimpson/zlog/raw/master/download/ZlogUsersGuide-EN-0.9rc1.pdf
-Homepage:https://github.com/HardySimpson/zlog
-Author's Blog(in Chinese):http://my.oschina.net/HardySimpson/blog
-Author's Email:HardySimpson1984@gmail.com
+Download: https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz
+GettingStart: in doc directory of zlog-0.9.0.tar.gz, GettingStart-CN.txt GettingStart-EN.txt
+UsersGuide: in doc directory of zlog-0.9.0.tar.gz, UsersGuide-CN.pdf UsersGuide-EN.pdf
+Homepage(in English): http://hardysimpson.github.com/zlog
+Homepage(in Chinese): http://www.oschina.net/p/zlog
+Author's Blog(in Chinese): http://my.oschina.net/HardySimpson/blog
+Author's Email: HardySimpson1984@gmail.com
View
@@ -138,7 +138,11 @@ zlog是一个高性能、线程安全、灵活、概念清晰的纯C日志函数
\end_layout
\begin_layout Standard
-所以我写了zlog。
+所以我写了zlog。
+\end_layout
+
+\begin_layout Standard
+zlog在效率、功能、安全性上大大超过了log4c,并且是用c写成的,具有比较好的通用性。
\end_layout
\begin_layout Standard
@@ -212,30 +216,50 @@ MDC,一个log4j风格的键-值对的表,可以扩展用户自定义的字
软件下载:
\begin_inset CommandInset href
LatexCommand href
-target "https://github.com/HardySimpson/zlog/raw/master/download/zlog-0.9.0.tar.gz"
+target "https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz"
\end_inset
\end_layout
\begin_layout Standard
-详细使用攻略:
+上手指南:zlog-latest-stable.tar.gz包内doc目录下 GettingStart-CN.txt GettingStart-EN.txt
+\end_layout
+
+\begin_layout Standard
+使用攻略:zlog-latest-stable.tar.gz包内doc目录下 UsersGuide-CN.pdf UsersGuide-EN.pdf
+\end_layout
+
+\begin_layout Standard
+源代码:
\begin_inset CommandInset href
LatexCommand href
-target "https://github.com/HardySimpson/zlog/raw/master/download/ZlogUsersGuide-CN-0.9rc1.pdf"
+name "git@github.com:HardySimpson/zlog.git"
+target "git@github.com:HardySimpson/zlog.git"
\end_inset
\end_layout
\begin_layout Standard
-主页
+英文主页
\begin_inset CommandInset href
LatexCommand href
-name "https://github.com/HardySimpson/zlog"
-target "https://github.com/HardySimpson/zlog"
+target "http://hardysimpson.github.com/zlog"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+中文主页:
+\begin_inset CommandInset href
+LatexCommand href
+name "http://www.oschina.net/p/zlog"
+target "http://www.oschina.net/p/zlog"
\end_inset
@@ -301,8 +325,8 @@ Hello World
下载
\begin_inset CommandInset href
LatexCommand href
-name "zlog-0.9.0.tar.gz"
-target "https://github.com/HardySimpson/zlog/raw/master/download/zlog-0.9.0.tar.gz"
+name "zlog-latest-stable.tar.gz"
+target "https://github.com/downloads/HardySimpson/zlog/zlog-latest-stable.tar.gz"
type "file:"
\end_inset
@@ -311,7 +335,7 @@ type "file:"
\end_layout
\begin_layout LyX-Code
-$ tar -zxvf zlog-0.9.0.tar.gz
+$ tar -zxvf zlog-latest-stable.tar.gz
\end_layout
\begin_layout LyX-Code
Oops, something went wrong.

0 comments on commit 924b15f

Please sign in to comment.