-SUBDIRS = modules codedocs pdns/docs
+SUBDIRS = modules codedocs docs
if WITH_PDNS_SERVER
SUBDIRS += pdns
modules/Makefile
pdns/Makefile
codedocs/Makefile
+ docs/Makefile
pdns/pdns.init
- pdns/docs/Makefile
pdns/ext/Makefile
pdns/ext/yahttp/Makefile
pdns/ext/yahttp/yahttp/Makefile
clean:
-make distclean
- -make -C pdns/docs clean
+ -make -C docs clean
rm -f debian/files debian/substvars stamp-build stamp-build-static
rm -rf "$(tmpdir)"
If you note an issue with the new documentation, please open a ticket on
[GitHub](https://github.com/powerdns/pdns/issues) and tell us about it. Or, even
-better, fork our repo, and edit the files in pdns/docs/markdown to improve things.
+better, fork our repo, and edit the files in docs/markdown to improve things.
If your change is simple (say, a typo or a new paragraph), you can do all this
entirely from GitHub. Simply fork PowerDNS, find the Markdown file you want to change,
[Virtualenvwrapper](http://virtualenvwrapper.readthedocs.org/en/latest/) can be
used to easily create and use a virtualenv.
-Once you're in a virtualenv, `pip install mkdocs==0.11.1 pandocfilters==1.2.3
-pandoc==1.0.0-alpha.3`.
+Once you're in a virtualenv, `pip install mkdocs==0.11.1 pandocfilters==1.2.3`.
-To test-build the documentation, `make html-new/index.html` in the pdns/docs
-directory will build the documentation into `html-new/`.
+To test-build the documentation, `make html/index.html` in the docs
+directory will build the documentation into `html/`.
To test your changes live, use `mkdocs serve --dev-addr=0.0.0.0:8000`, and the
new version of your documentation will appear on port 8000 of your machine.
The default setup conforms to the following schema:
```
-!!include=../../modules/gmysqlbackend/schema.mysql.sql
+!!include=../modules/gmysqlbackend/schema.mysql.sql
```
`zone2sql` with the `--gmysql` flag also assumes this layout is in place.
The default setup conforms to the following schema, which you should add to a PostgreSQL database.
```
-!!include=../../modules/gpgsqlbackend/schema.pgsql.sql
+!!include=../modules/gpgsqlbackend/schema.pgsql.sql
```
`zone2sql` with the `--gpgsql` flag also assumes this layout is in place.
Generic Oracle support is only available since version 2.9.18. The default setup conforms to the following schema, which you should add to an Oracle database. You may need or want to add `namespace` statements.
```
-!!include=../../modules/gpgsqlbackend/schema.pgsql.sql
+!!include=../modules/gpgsqlbackend/schema.pgsql.sql
```
This schema contains all elements needed for master, slave and superslave operation.
Before you can use this backend you first have to set it up and fill it with data. The default setup conforms to the following schema:
```
-!!include=../../modules/gsqlite3backend/schema.sqlite3.sql
+!!include=../modules/gsqlite3backend/schema.sqlite3.sql
```
This schema contains all elements needed for master, slave and superslave operation.
## Sample perl backend
```
-!!include=../../modules/pipebackend/backend.pl
+!!include=../modules/pipebackend/backend.pl
```
Connect to MySQL as a user with sufficient privileges and issue the following commands:
```
-!!include=../../modules/gmysqlbackend/schema.mysql.sql
+!!include=../modules/gmysqlbackend/schema.mysql.sql
```
Now we have a database and an empty table. PDNS should now be able to launch in monitor mode and display no errors:
### gmysql backend with nodnssec schema
```
-!!include=../../modules/gmysqlbackend/nodnssec-3.x_to_3.4.0_schema.mysql.sql
+!!include=../modules/gmysqlbackend/nodnssec-3.x_to_3.4.0_schema.mysql.sql
```
### gmysql backend with dnssec schema
```
-!!include=../../modules/gmysqlbackend/dnssec-3.x_to_3.4.0_schema.mysql.sql
+!!include=../modules/gmysqlbackend/dnssec-3.x_to_3.4.0_schema.mysql.sql
```
### gpgsql backend with nodnssec schema
```
-!!include=../../modules/gpgsqlbackend/nodnssec-3.x_to_3.4.0_schema.pgsql.sql
+!!include=../modules/gpgsqlbackend/nodnssec-3.x_to_3.4.0_schema.pgsql.sql
```
### gpgsql backend with dnssec schema:
```
-!!include=../../modules/gpgsqlbackend/dnssec-3.x_to_3.4.0_schema.pgsql.sql
+!!include=../modules/gpgsqlbackend/dnssec-3.x_to_3.4.0_schema.pgsql.sql
```
### gsqlite3 backend with nodnssec schema
```
-!!include=../../modules/gsqlite3backend/nodnssec-3.x_to_3.4.0_schema.sqlite3.sql
+!!include=../modules/gsqlite3backend/nodnssec-3.x_to_3.4.0_schema.sqlite3.sql
```
### gsqlite3 backend with dnssec schema:
```
-!!include=../../modules/gsqlite3backend/dnssec-3.x_to_3.4.0_schema.sqlite3.sql
+!!include=../modules/gsqlite3backend/dnssec-3.x_to_3.4.0_schema.sqlite3.sql
```
### goracle backend:
By default, security polling happens on the domain 'secpoll.powerdns.com', but this can be changed with the security-poll-suffix. If this setting is made empty, no polling will take place. Organizations wanting to host their own security zones can do so by changing this setting to a domain name under their control.
-To make this easier, the zone used to host secpoll.powerdns.com is available [here](https://github.com/PowerDNS/pdns/blob/master/pdns/docs/secpoll.zone).
+To make this easier, the zone used to host secpoll.powerdns.com is available [here](https://github.com/PowerDNS/pdns/blob/master/docs/secpoll.zone).
To enable distributors of PowerDNS to signal that they have backported versions, the PACKAGEVERSION compilation-time macro can be used to set a distributor suffix.
AC_DEFUN([PDNS_CHECK_MKDOCS], [
- AC_REQUIRE([AC_PROG_EGREP])
AC_CHECK_PROG([MKDOCS], [mkdocs], [yes], [no])
AS_IF([test "x$MKDOCS" = "xno"], [
- AS_IF([test ! -d "$scrdir/pdns/docs/html" ],
+ AS_IF([test ! -d "$scrdir/docs/html" ],
[AC_MSG_WARN([mkdocs is missing, unable to build documentation.])]
)
])
AC_DEFUN([PDNS_CHECK_PANDOC], [
AC_CHECK_PROG([PANDOC], [pandoc], [yes], [no])
- AC_REQUIRE([AC_PROG_EGREP])
AS_IF([test "x$PANDOC" = "xno"], [
- AS_IF([test ! -d "$srcdir/pdns/docs/html" -o ! -f "$srcdir/pdns/docs/pdns_server.1"],
+ AS_IF([test ! -d "$srcdir/docs/html" -o ! -f "$srcdir/docs/pdns_server.1"],
[AC_MSG_WARN([pandoc is missing, unable to build documentation and manpages.])]
)
])
responsestats.cc webserver.cc rec-carbon.cc secpoll-recursor.cc"
./mkpubsuffixcc
-cd docs
-make pdns_recursor.1 rec_control.1
-cd ..
DIRNAME=pdns-recursor-$VERSION
rm -rf $DIRNAME
cp tools/rrd/{create,update,makegraphs,index.html} $DIRNAME/rrd
cp dnslabeltext.rl $DIRNAME
cp pdns-recursor.init.d $DIRNAME
-cp docs/pdns_recursor.1 docs/rec_control.1 $DIRNAME
+cp ../docs/pdns_recursor.1 ../docs/rec_control.1 $DIRNAME
cp configure-recursor $DIRNAME/configure
cp powerdns-example-script.lua $DIRNAME
mkdir -p $DIRNAME/contrib