Skip to content

Commit 10e6b4f

Browse files
committed
prepare release 2.3.0
1 parent bd3f388 commit 10e6b4f

6 files changed

Lines changed: 90 additions & 38 deletions

File tree

CMakeLists.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11

22
cmake_minimum_required(VERSION 3.10.0)
33

4-
project(osm2pgsql VERSION 2.2.0 LANGUAGES CXX C)
4+
project(osm2pgsql VERSION 2.3.0 LANGUAGES CXX C)
55

66
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
77

man/osm2pgsql-expire.1

Lines changed: 35 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,102 +1,103 @@
1-
.TH "OSM2PGSQL" "1" "2.2.0" "" ""
1+
.TH "OSM2PGSQL" "1" "2.3.0" "" ""
22
.SH NAME
3-
.PP
4-
osm2pgsql-expire - Visualize expire output
3+
osm2pgsql\-expire \- Visualize expire output
54
.SH SYNOPSIS
6-
.PP
7-
\f[B]osm2pgsql-expire\f[R] [\f[I]OPTIONS\f[R]] \f[I]OSM-FILE\f[R] (1)
8-
\f[B]osm2pgsql-expire\f[R] \f[I]TILES-FILE\f[R] (2)
5+
\f[B]osm2pgsql\-expire\f[R] [\f[I]OPTIONS\f[R]] \f[I]OSM\-FILE\f[R] (1)
6+
\f[B]osm2pgsql\-expire\f[R] \f[I]TILES\-FILE\f[R] (2)
97
.SH DESCRIPTION
10-
.PP
118
\f[B]This command is currently experimental.\f[R]
129
.PP
1310
The expire command can be used for two things:
1411
.IP "1." 3
1512
\f[B]To check what tiles some OSM data is in.\f[R] If an
16-
\f[I]OSM-FILE\f[R] is specified osm2pgsql-expire will calculate the
13+
\f[I]OSM\-FILE\f[R] is specified osm2pgsql\-expire will calculate the
1714
tiles covering the objects in that file.
1815
Note that the file must not be a change file but a regular OSM data
1916
file!
2017
Output is, by default, a tile file, but GeoJSON is also possible.
2118
Covering tiles are only calculated for tagged objects.
2219
.IP "2." 3
23-
\f[B]Visualize tile list.\f[R] If a \f[I]TILE-FILE\f[R] (presumably
20+
\f[B]Visualize tile list.\f[R] If a \f[I]TILE\-FILE\f[R] (presumably
2421
generated by osm2pgsql) is specified, a GeoJSON file is generated
2522
showing all mentioned tiles.
2623
In this mode all command line options are ignored.
2724
.PP
2825
Read the \f[I]Expire\f[R] chapter of the osm2pgsql manual
2926
(https://osm2pgsql.org/doc/manual.html#expire) for details on how to
30-
interpret the \f[V]-m, \[rs]--mode\f[R] and
31-
\f[V]\[rs]--full-area-limit\f[R] options.
27+
interpret the \f[CR]\-m, \[rs]\-\-mode\f[R] and
28+
\f[CR]\[rs]\-\-full\-area\-limit\f[R] options.
3229
.SH GEOMETRY GENERATION
33-
.PP
3430
To calculate the tiles covering the specified OSM data in mode (1), a
3531
geometry has to be generated first for each object.
3632
This works as follow:
3733
.IP \[bu] 2
3834
For nodes a point geometry will be generated.
3935
.IP \[bu] 2
40-
For closed ways a polygon geometry will be generated, for non-closed
36+
For closed ways a polygon geometry will be generated, for non\-closed
4137
ways a linestring geometry.
4238
If a generated polygon is not valid, the program will fall back to a
4339
linestring.
4440
If neither a valid polygon nor a valid linestring can be generated the
4541
object is ignored.
4642
.IP \[bu] 2
47-
For relations a geometry is generated based on the \f[V]type\f[R] tag.
48-
For types \f[V]multipolygon\f[R] and \f[V]boundary\f[R], a multipolygon
49-
geometry is created, for types \f[V]route\f[R] and
50-
\f[V]multilinestring\f[R] a multilinestring geometry is created, for all
51-
other types a geometry collection is created.
43+
For relations a geometry is generated based on the \f[CR]type\f[R] tag.
44+
For types \f[CR]multipolygon\f[R] and \f[CR]boundary\f[R], a
45+
multipolygon geometry is created, for types \f[CR]route\f[R] and
46+
\f[CR]multilinestring\f[R] a multilinestring geometry is created, for
47+
all other types a geometry collection is created.
5248
.PP
5349
Note that for (multi)polygons it depends on the command line options
54-
--mode and --full-area-limit whether the tiles calculation is based on
55-
the area or the boundary of the (multi)polygons.
50+
\-\-mode and \-\-full\-area\-limit whether the tiles calculation is
51+
based on the area or the boundary of the (multi)polygons.
5652
.SH OPTIONS
57-
.PP
5853
This program follows the usual GNU command line syntax, with long
59-
options starting with two dashes (\f[V]--\f[R]).
54+
options starting with two dashes (\f[CR]\-\-\f[R]).
6055
Mandatory arguments to long options are mandatory for short options too.
6156
.SH MAIN OPTIONS
6257
.TP
63-
-b, --buffer=VALUE
58+
\-b, \-\-buffer=VALUE
6459
Set buffer size around geometry relative to tile size.
6560
Example: Set to 0.1 for a buffer that\[cq]s 10% of the tile size.
6661
.TP
67-
-f, --format=FORMAT
62+
\-f, \-\-format=FORMAT
6863
Output format.
6964
Options are `tiles' (default) or `geojson'.
7065
The GeoJSON output uses the Web Mercator projection (EPSG:3857) which is
7166
supported by many programs although, strictly speaking, it is not
7267
allowed by the GeoJSON spec.
7368
.TP
74-
--full-area-limit=VALUE
69+
\-\-full\-area\-limit=VALUE
7570
Set full area limit.
7671
.TP
77-
-m, --mode=MODE
72+
\-m, \-\-mode=MODE
7873
Set expire mode.
79-
One of \f[V]boundary_only\f[R], \f[V]full_area\f[R] (default), and
80-
\f[V]hybrid\f[R].
74+
One of \f[CR]boundary_only\f[R], \f[CR]full_area\f[R] (default), and
75+
\f[CR]hybrid\f[R].
8176
.TP
82-
-z, --zoom=ZOOM
77+
\-z, \-\-zoom=ZOOM
8378
Zoom level on which to calculate tiles.
8479
.SH HELP/VERSION OPTIONS
8580
.TP
86-
-h, --help
81+
\-h, \-\-help
8782
Print help.
8883
.TP
89-
-V, --version
84+
\-V, \-\-version
9085
Print osm2pgsql version.
9186
.SH LOGGING OPTIONS
9287
.TP
93-
--log-level=LEVEL
88+
\-\-log\-level=LEVEL
9489
Set log level (`debug', `info' (default), `warn', or `error').
9590
.SH SEE ALSO
9691
.IP \[bu] 2
97-
osm2pgsql website (https://osm2pgsql.org)
92+
\c
93+
.UR https://osm2pgsql.org
94+
osm2pgsql website
95+
.UE \c
9896
.IP \[bu] 2
99-
osm2pgsql manual (https://osm2pgsql.org/doc/manual.html)
97+
\c
98+
.UR https://osm2pgsql.org/doc/manual.html
99+
osm2pgsql manual
100+
.UE \c
100101
.IP \[bu] 2
101102
\f[B]osm2pgsql\f[R](1)
102103
.IP \[bu] 2

man/osm2pgsql-gen.1

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.TH "OSM2PGSQL" "1" "2.2.0" "" ""
1+
.TH "OSM2PGSQL" "1" "2.3.0" "" ""
22
.SH NAME
33
osm2pgsql\-gen \- Generalize OpenStreetMap data \- EXPERIMENTAL!
44
.SH SYNOPSIS

man/osm2pgsql-replication.1

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.TH "OSM2PGSQL-REPLICATION" "1" "2.2.0" "" ""
1+
.TH "OSM2PGSQL-REPLICATION" "1" "2.3.0" "" ""
22
.SH NAME
33
osm2pgsql\-replication \- osm2pgsql database updater
44
.SH SYNOPSIS

man/osm2pgsql-test-style.1

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
.TH "OSM2PGSQL-TEST-STYLE" "1" "2.3.0" "" ""
2+
.SH NAME
3+
osm2pgsql\-test\-style \- osm2pgsql style testing
4+
.SH SYNOPSIS
5+
.B osm2pgsql\-test\-style
6+
[-h] [--osm2pgsql-binary OSM2PGSQL_BINARY] [--test-data-dir TEST_DATA_DIR] [--style-data-dir STYLE_DATA_DIR] [--test-db TEST_DB] [--template-test-db TEMPLATE_TEST_DB] [--keep-test-db] [--test-tablespace {yes,no,auto}] [--test-proj {yes,no,auto}] features [features ...]
7+
.SH DESCRIPTION
8+
Test runner for BDD\-style integration tests.
9+
10+
See osm2pgsql manual for more information on osm2pgsql style testing.
11+
12+
.TP
13+
\fBfeatures\fR
14+
Feature files or paths
15+
16+
.SH OPTIONS
17+
.TP
18+
\fB\-\-osm2pgsql\-binary\fR \fI\,OSM2PGSQL_BINARY\/\fR
19+
osm2pgsql binary to use for testing (default: osm2pgsql)
20+
21+
.TP
22+
\fB\-\-test\-data\-dir\fR \fI\,TEST_DATA_DIR\/\fR
23+
(optional) directory to search for test data
24+
25+
.TP
26+
\fB\-\-style\-data\-dir\fR \fI\,STYLE_DATA_DIR\/\fR
27+
(optional) directory to search for style files
28+
29+
.TP
30+
\fB\-\-test\-db\fR \fI\,TEST_DB\/\fR
31+
Name of database to use for testing (default: osm2pgsql\-test)
32+
33+
.TP
34+
\fB\-\-template\-test\-db\fR \fI\,TEMPLATE_TEST_DB\/\fR
35+
Name of database to use for creating the template db (default: osm2pgsql\-test\-template)
36+
37+
.TP
38+
\fB\-\-keep\-test\-db\fR
39+
Keep the test database around after tests are done
40+
41+
.TP
42+
\fB\-\-test\-tablespace\fR \fI\,{yes,no,auto}\/\fR
43+
Include tests requiring a tablespace
44+
45+
.TP
46+
\fB\-\-test\-proj\fR \fI\,{yes,no,auto}\/\fR
47+
Include tests requiring the proj library
48+
.SH SEE ALSO
49+
* osm2pgsql website (https://osm2pgsql.org)
50+
* osm2pgsql manual (https://osm2pgsql.org/doc/manual.html)
51+

man/osm2pgsql.1

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.TH "OSM2PGSQL" "1" "2.2.0" "" ""
1+
.TH "OSM2PGSQL" "1" "2.3.0" "" ""
22
.SH NAME
33
osm2pgsql \- OpenStreetMap data to PostgreSQL converter
44
.SH SYNOPSIS

0 commit comments

Comments
 (0)