git.m6w6.name Git - awesomized/libmemcached/blob - docs/Makefile.am

   1 # This file generates all of man/html pages that we use for documentation.
   2 #
   3 # When hacking this file you need to know that we take .pod files and turn
   4 # them into .pop files. .pop files are 1=1 for man pages, but one .pod
   5 # file may generate many .pop files.
   6 #
   7 #    -Brian
   8 #
   9 #
  10 CLEANFILES= *.1 *.3 *.html *.pop *.tmp
  11
  12 BUILT_SOURCES=
  13
  14 EXTRA_DIST= make_index.pl
  15
  16 AUTO_PAGES= \
  17             memcached_increment.pop \
  18             memcached_increment_with_initial.pop \
  19             memcached_decrement.pop \
  20             memcached_decrement_with_initial.pop
  21 BUILT_SOURCES += ${AUTO_PAGES}
  22
  23 BEHAVIOR_PAGES= \
  24                 memcached_behavior_get.pop \
  25                 memcached_behavior_set.pop
  26 BUILT_SOURCES += ${BEHAVIOR_PAGES}
  27
  28 CALLBACK_PAGES= \
  29                 memcached_callback_get.pop \
  30                 memcached_callback_set.pop
  31 BUILT_SOURCES += ${CALLBACK_PAGES}
  32
  33 CREATE_PAGES= \
  34               memcached_clone.pop \
  35               memcached_create.pop \
  36               memcached_free.pop \
  37               memcached_servers_reset.pop
  38 BUILT_SOURCES += ${CREATE_PAGES}
  39
  40 DELETE_PAGES= \
  41               memcached_delete.pop \
  42               memcached_delete_by_key.pop
  43 BUILT_SOURCES += ${DELETE_PAGES}
  44
  45 GENERIC_PAGES= \
  46                libmemcached.pop \
  47                libmemcached_examples.pop \
  48                libmemcachedutil.pop \
  49                memcached_analyze.pop \
  50                memcached_dump.pop \
  51                memcached_flush.pop \
  52                memcached_flush_buffers.pop \
  53                memcached_generate_hash_value.pop \
  54                memcached_quit.pop \
  55                memcached_strerror.pop \
  56                memcached_verbosity.pop \
  57                memcapable.pop \
  58                memcat.pop \
  59                memcp.pop \
  60                memdump.pop \
  61                memerror.pop \
  62                memflush.pop \
  63                memrm.pop \
  64                memaslap.pop \
  65                memslap.pop \
  66                memstat.pop
  67 BUILT_SOURCES += ${GENERIC_PAGES}
  68
  69 GET_PAGES= \
  70            memcached_get.pop \
  71            memcached_get_by_key.pop \
  72            memcached_fetch_result.pop \
  73            memcached_fetch_execute.pop \
  74            memcached_mget.pop \
  75            memcached_mget_by_key.pop \
  76            memcached_mget_execute.pop \
  77            memcached_mget_execute_by_key.pop \
  78            memcached_fetch.pop
  79 BUILT_SOURCES += ${GET_PAGES}
  80
  81 MEMORY_ALLOCATORS_PAGES= \
  82                          memcached_get_memory_allocators.pop \
  83                          memcached_set_memory_allocators.pop \
  84                          memcached_set_memory_allocators_context.pop
  85 BUILT_SOURCES += ${MEMORY_ALLOCATORS_PAGES}
  86
  87 POOL_PAGES= \
  88             memcached_pool_behavior_get.pop \
  89             memcached_pool_behavior_set.pop \
  90             memcached_pool_create.pop \
  91             memcached_pool_destroy.pop \
  92             memcached_pool_pop.pop \
  93             memcached_pool_push.pop
  94 BUILT_SOURCES += ${POOL_PAGES}
  95
  96 RESULT_PAGES= \
  97               memcached_result_cas.pop \
  98               memcached_result_create.pop \
  99               memcached_result_flags.pop \
 100               memcached_result_free.pop \
 101               memcached_result_key_length.pop \
 102               memcached_result_key_value.pop \
 103               memcached_result_length.pop \
 104               memcached_result_st.pop \
 105               memcached_result_value.pop
 106 BUILT_SOURCES += ${RESULT_PAGES}
 107
 108
 109 SERVER_PAGES= \
 110               memcached_server_count.pop \
 111               memcached_server_cursor.pop \
 112               memcached_server_list.pop \
 113               memcached_server_add.pop \
 114               memcached_server_add_unix_socket.pop \
 115               memcached_server_push.pop
 116 BUILT_SOURCES += ${SERVER_PAGES}
 117
 118 SERVER_ST_PAGES= \
 119                  memcached_server_list_free.pop \
 120                  memcached_server_list_count.pop \
 121                  memcached_server_list_append.pop \
 122                  memcached_servers_parse.pop
 123 BUILT_SOURCES += ${SERVER_ST_PAGES}
 124
 125 SET_PAGES= \
 126            memcached_set.pop \
 127            memcached_set_by_key.pop \
 128            memcached_cas.pop \
 129            memcached_cas_by_key.pop \
 130            memcached_replace.pop \
 131            memcached_replace_by_key.pop \
 132            memcached_add.pop \
 133            memcached_add_by_key.pop \
 134            memcached_prepend.pop \
 135            memcached_prepend_by_key.pop \
 136            memcached_append.pop \
 137            memcached_append_by_key.pop
 138 BUILT_SOURCES += ${SET_PAGES}
 139
 140 STATS_PAGES= \
 141              memcached_stat.pop \
 142              memcached_stat_execute.pop\
 143              memcached_stat_get_keys.pop\
 144              memcached_stat_get_value.pop \
 145              memcached_stat_servername.pop
 146 BUILT_SOURCES += ${STATS_PAGES}
 147
 148 USER_DATA_PAGES= \
 149                  memcached_get_user_data.pop \
 150                  memcached_set_user_data.pop
 151 BUILT_SOURCES += ${USER_DATA_PAGES}
 152
 153 VERSION_PAGES= \
 154                memcached_version.pop \
 155                memcached_lib_version.pop
 156 BUILT_SOURCES += ${VERSION_PAGES}
 157
 158
 159 #
 160 # These are for libhashkit
 161 #
 162 HASHKIT_CREATE_PAGES= \
 163                       hashkit_is_allocated.pop \
 164                       hashkit_create.pop \
 165                       hashkit_clone.pop \
 166                       hashkit_free.pop
 167 BUILT_SOURCES += ${HASHKIT_CREATE_PAGES}
 168
 169 HASHKIT_FUNCTIONS_PAGES= \
 170                          hashkit_crc32.pop \
 171                          hashkit_fnv1_32.pop \
 172                          hashkit_fnv1_64.pop \
 173                          hashkit_fnv1a_32.pop \
 174                          hashkit_fnv1a_64.pop \
 175                          hashkit_functions.pop \
 176                          hashkit_hsieh.pop \
 177                          hashkit_jenkins.pop \
 178                          hashkit_md5.pop \
 179                          hashkit_murmur.pop
 180 BUILT_SOURCES += ${HASHKIT_FUNCTIONS_PAGES}
 181
 182 HASHKIT_ST_PAGES= \
 183                   hashkit_value.pop
 184 BUILT_SOURCES += ${HASHKIT_ST_PAGES}
 185
 186
 187 HTML_FILES= \
 188             hashkit_clone.html \
 189             hashkit_crc32.html \
 190             hashkit_create.html \
 191             hashkit_fnv1_32.html \
 192             hashkit_fnv1_64.html \
 193             hashkit_fnv1a_32.html \
 194             hashkit_fnv1a_64.html \
 195             hashkit_free.html \
 196             hashkit_functions.html \
 197             hashkit_hsieh.html \
 198             hashkit_is_allocated.html \
 199             hashkit_jenkins.html \
 200             hashkit_md5.html \
 201             hashkit_murmur.html \
 202             hashkit_value.html \
 203             libmemcached_examples.html \
 204             libmemcached.html \
 205             libmemcachedutil.html \
 206             memcached_add_by_key.html \
 207             memcached_add.html \
 208             memcached_analyze.html \
 209             memcached_append_by_key.html \
 210             memcached_append.html \
 211             memcached_behavior_get.html \
 212             memcached_behavior_set.html \
 213             memcached_callback_get.html \
 214             memcached_callback_set.html \
 215             memcached_cas_by_key.html \
 216             memcached_cas.html \
 217             memcached_clone.html \
 218             memcached_create.html \
 219             memcached_decrement.html \
 220             memcached_decrement_with_initial.html \
 221             memcached_delete_by_key.html \
 222             memcached_delete.html \
 223             memcached_dump.html \
 224             memcached_fetch_execute.html \
 225             memcached_fetch.html \
 226             memcached_fetch_result.html \
 227             memcached_flush_buffers.html \
 228             memcached_flush.html \
 229             memcached_free.html \
 230             memcached_generate_hash_value.html \
 231             memcached_get_by_key.html \
 232             memcached_get_memory_allocators.html \
 233             memcached_get.html \
 234             memcached_get_user_data.html \
 235             memcached_increment.html \
 236             memcached_increment_with_initial.html \
 237             memcached_lib_version.html \
 238             memcached_mget_by_key.html \
 239             memcached_mget_execute_by_key.html \
 240             memcached_mget_execute.html \
 241             memcached_mget.html \
 242             memcached_pool_behavior_get.html \
 243             memcached_pool_behavior_set.html \
 244             memcached_pool_create.html \
 245             memcached_pool_destroy.html \
 246             memcached_pool_pop.html \
 247             memcached_pool_push.html \
 248             memcached_prepend_by_key.html \
 249             memcached_prepend.html \
 250             memcached_quit.html \
 251             memcached_replace_by_key.html \
 252             memcached_replace.html \
 253             memcached_result_cas.html \
 254             memcached_result_create.html \
 255             memcached_result_flags.html \
 256             memcached_result_free.html \
 257             memcached_result_key_length.html \
 258             memcached_result_key_value.html \
 259             memcached_result_length.html \
 260             memcached_result_st.html \
 261             memcached_result_value.html \
 262             memcached_server_add.html \
 263             memcached_server_add_unix_socket.html \
 264             memcached_server_count.html \
 265             memcached_server_cursor.html \
 266             memcached_server_list_append.html \
 267             memcached_server_list_count.html \
 268             memcached_server_list_free.html \
 269             memcached_server_list.html \
 270             memcached_server_push.html \
 271             memcached_servers_parse.html \
 272             memcached_set_by_key.html \
 273             memcached_set_memory_allocators.html \
 274             memcached_set.html \
 275             memcached_set_user_data.html \
 276             memcached_stat_execute.html \
 277             memcached_stat_get_keys.html \
 278             memcached_stat_get_value.html \
 279             memcached_stat.html \
 280             memcached_stat_servername.html \
 281             memcached_strerror.html \
 282             memcached_verbosity.html \
 283             memcached_version.html \
 284             memcapable.html \
 285             memcat.html \
 286             memcp.html \
 287             memdump.html \
 288             memerror.html \
 289             memflush.html \
 290             memrm.html \
 291             memaslap.html \
 292             memslap.html \
 293             memstat.html
 294
 295 POD_FILES= \
 296            hashkit_create.pod \
 297            hashkit_functions.pod \
 298            hashkit_value.pod \
 299            libmemcached.pod \
 300            libmemcached_examples.pod \
 301            libmemcachedutil.pod \
 302            memcached_analyze.pod \
 303            memcached_auto.pod \
 304            memcached_behavior.pod \
 305            memcached_callback.pod \
 306            memcached_create.pod \
 307            memcached_delete.pod \
 308            memcached_dump.pod \
 309            memcached_flush.pod \
 310            memcached_flush_buffers.pod \
 311            memcached_generate_hash_value.pod \
 312            memcached_get.pod \
 313            memcached_memory_allocators.pod \
 314            memcached_pool.pod \
 315            memcached_quit.pod \
 316            memcached_result_st.pod \
 317            memcached_sasl.pod \
 318            memcached_server_st.pod \
 319            memcached_servers.pod \
 320            memcached_set.pod \
 321            memcached_stats.pod \
 322            memcached_strerror.pod \
 323            memcached_user_data.pod \
 324            memcached_verbosity.pod \
 325            memcached_version.pod \
 326            memcapable.pod \
 327            memcat.pod \
 328            memcp.pod \
 329            memdump.pod \
 330            memerror.pod \
 331            memflush.pod \
 332            memrm.pod \
 333            memaslap.pod \
 334            memslap.pod \
 335            memstat.pod
 336 EXTRA_DIST+= $(POD_FILES)
 337
 338 man_MANS = \
 339            hashkit_clone.3 \
 340            hashkit_crc32.3 \
 341            hashkit_create.3 \
 342            hashkit_fnv1_32.3 \
 343            hashkit_fnv1_64.3 \
 344            hashkit_fnv1a_32.3 \
 345            hashkit_fnv1a_64.3 \
 346            hashkit_free.3 \
 347            hashkit_functions.3 \
 348            hashkit_hsieh.3 \
 349            hashkit_is_allocated.3 \
 350            hashkit_jenkins.3 \
 351            hashkit_md5.3 \
 352            hashkit_murmur.3 \
 353            hashkit_value.3 \
 354            libmemcached.3 \
 355            libmemcached_examples.3 \
 356            memcached_add.3 \
 357            memcached_add_by_key.3 \
 358            memcached_analyze.3 \
 359            memcached_append.3 \
 360            memcached_append_by_key.3 \
 361            memcached_behavior_get.3 \
 362            memcached_behavior_set.3 \
 363            memcached_callback_get.3 \
 364            memcached_callback_set.3 \
 365            memcached_cas.3 \
 366            memcached_cas_by_key.3 \
 367            memcached_clone.3 \
 368            memcached_create.3 \
 369            memcached_decrement.3 \
 370            memcached_decrement_with_initial.3 \
 371            memcached_delete.3 \
 372            memcached_delete_by_key.3 \
 373            memcached_dump.3 \
 374            memcached_fetch.3 \
 375            memcached_fetch_execute.3 \
 376            memcached_fetch_result.3 \
 377            memcached_flush_buffers.3 \
 378            memcached_free.3 \
 379            memcached_generate_hash_value.3 \
 380            memcached_get.3 \
 381            memcached_get_by_key.3 \
 382            memcached_get_memory_allocators.3 \
 383            memcached_get_user_data.3 \
 384            memcached_increment.3 \
 385            memcached_increment_with_initial.3 \
 386            memcached_lib_version.3 \
 387            memcached_mget.3 \
 388            memcached_mget_by_key.3 \
 389            memcached_mget_execute.3  \
 390            memcached_mget_execute_by_key.3  \
 391            memcached_prepend.3 \
 392            memcached_prepend_by_key.3 \
 393            memcached_quit.3 \
 394            memcached_replace.3 \
 395            memcached_replace_by_key.3 \
 396            memcached_server_add.3 \
 397            memcached_server_count.3 \
 398            memcached_server_cursor.3 \
 399            memcached_server_list.3 \
 400            memcached_server_list_append.3 \
 401            memcached_server_list_count.3 \
 402            memcached_server_list_free.3 \
 403            memcached_server_push.3 \
 404            memcached_servers_parse.3 \
 405            memcached_set.3 \
 406            memcached_set_by_key.3 \
 407            memcached_set_memory_allocators.3 \
 408            memcached_set_user_data.3 \
 409            memcached_stat.3 \
 410            memcached_stat_execute.3 \
 411            memcached_stat_get_keys.3 \
 412            memcached_stat_get_value.3 \
 413            memcached_stat_servername.3 \
 414            memcached_strerror.3 \
 415            memcached_verbosity.3 \
 416            memcached_version.3 \
 417            memcapable.1 \
 418            memcat.1 \
 419            memcp.1 \
 420            memdump.1 \
 421            memerror.1 \
 422            memflush.1 \
 423            memrm.1 \
 424            memaslap.1 \
 425            memslap.1 \
 426            memstat.1
 427
 428 if HAVE_SASL
 429 POD_FILES+= memcached_sasl.pod
 430 man_MANS+= \
 431            memcached_destroy_sasl_auth_data.3 \
 432            memcached_get_sasl_callbacks.3 \
 433            memcached_sasl_set_auth_data.3 \
 434            memcached_set_sasl_callbacks.3
 435
 436 HTML_FILES+= \
 437            memcached_destroy_sasl_auth_data.html \
 438            memcached_get_sasl_callbacks.html \
 439            memcached_sasl_set_auth_data.html \
 440            memcached_set_sasl_callbacks.html
 441
 442
 443 SASL_PAGES= \
 444            memcached_destroy_sasl_auth_data.pop \
 445            memcached_get_sasl_callbacks.pop \
 446            memcached_sasl_set_auth_data.pop \
 447            memcached_set_sasl_callbacks.pop
 448 BUILT_SOURCES += ${SASL_PAGES}
 449
 450 ${SASL_PAGES}:
 451         @rm -f $@
 452         ln -s ${top_srcdir}/docs/memcached_sasl.pod ${top_builddir}/docs/$@
 453
 454 endif
 455
 456 if BUILD_LIBMEMCACHEDUTIL
 457 man_MANS+= \
 458           libmemcachedutil.3 \
 459           memcached_pool_behavior_set.3 \
 460           memcached_pool_behavior_get.3 \
 461           memcached_pool_create.3 \
 462           memcached_pool_destroy.3 \
 463           memcached_pool_push.3 \
 464           memcached_pool_pop.3
 465 endif
 466
 467
 468 ${CREATE_PAGES}:
 469         @rm -f $@
 470         ln -s ${top_srcdir}/docs/memcached_create.pod ${top_builddir}/docs/$@
 471
 472 ${SET_PAGES}:
 473         @rm -f $@
 474         ln -s ${top_srcdir}/docs/memcached_set.pod ${top_builddir}/docs/$@
 475
 476 ${DELETE_PAGES}:
 477         @rm -f $@
 478         ln -s ${top_srcdir}/docs/memcached_delete.pod ${top_builddir}/docs/$@
 479
 480 ${AUTO_PAGES}:
 481         @rm -f $@
 482         ln -s ${top_srcdir}/docs/memcached_auto.pod ${top_builddir}/docs/$@
 483
 484 ${GET_PAGES}:
 485         @rm -f $@
 486         ln -s ${top_srcdir}/docs/memcached_get.pod ${top_builddir}/docs/$@
 487
 488 ${SERVER_PAGES}:
 489         @rm -f $@
 490         ln -s ${top_srcdir}/docs/memcached_servers.pod ${top_builddir}/docs/$@
 491
 492 ${SERVER_ST_PAGES}:
 493         @rm -f $@
 494         ln -s ${top_srcdir}/docs/memcached_server_st.pod ${top_builddir}/docs/$@
 495
 496 ${GENERIC_PAGES}:
 497         @rm -f $@
 498         ln -s ${top_srcdir}/docs/$*.pod ${top_builddir}/docs/$@
 499
 500 ${BEHAVIOR_PAGES}:
 501         @rm -f $@
 502         ln -s ${top_srcdir}/docs/memcached_behavior.pod ${top_builddir}/docs/$@
 503
 504 ${CALLBACK_PAGES}:
 505         @rm -f $@
 506         ln -s ${top_srcdir}/docs/memcached_callback.pod ${top_builddir}/docs/$@
 507
 508 ${STATS_PAGES}:
 509         @rm -f $@
 510         ln -s ${top_srcdir}/docs/memcached_stats.pod ${top_builddir}/docs/$@
 511
 512 ${RESULT_PAGES}:
 513         @rm -f $@
 514         ln -s ${top_srcdir}/docs/memcached_result_st.pod ${top_builddir}/docs/$@
 515
 516 ${VERSION_PAGES}:
 517         @rm -f $@
 518         ln -s ${top_srcdir}/docs/memcached_version.pod ${top_builddir}/docs/$@
 519
 520 ${MEMORY_ALLOCATORS_PAGES}:
 521         @rm -f $@
 522         ln -s ${top_srcdir}/docs/memcached_memory_allocators.pod ${top_builddir}/docs/$@
 523
 524 ${USER_DATA_PAGES}:
 525         @rm -f $@
 526         ln -s ${top_srcdir}/docs/memcached_user_data.pod ${top_builddir}/docs/$@
 527
 528 ${POOL_PAGES}:
 529         @rm -f $@
 530         ln -s ${top_srcdir}/docs/memcached_pool.pod ${top_builddir}/docs/$@
 531
 532 ${HASHKIT_CREATE_PAGES}:
 533         @rm -f $@
 534         ln -s ${top_srcdir}/docs/hashkit_create.pod ${top_builddir}/docs/$@
 535
 536
 537 ${HASHKIT_FUNCTIONS_PAGES}:
 538         @rm -f $@
 539         ln -s ${top_srcdir}/docs/hashkit_functions.pod ${top_builddir}/docs/$@
 540
 541 ${HASHKIT_ST_PAGES}:
 542         @rm -f $@
 543         ln -s ${top_srcdir}/docs/hashkit_value.pod ${top_builddir}/docs/$@
 544
 545 test-docs: $(POD_FILES)
 546         ${PODCHECKER} $(top_srcdir)/docs/$?
 547
 548 html-local: html-pages html-index
 549
 550 html-pages: $(HTML_FILES)
 551
 552 html-index: html-pages
 553         perl make_index.pl *.html > index.html
 554
 555 SUFFIXES= .pop .pod .html .1 .3
 556
 557 .pop: ${_set}
 558
 559 .pop.html:
 560         pod2html --infile=$< >  $@
 561
 562 .pop.1:
 563         ${POD2MAN} -c "$*" -r "" -s 1 $< >  $@
 564
 565 .pop.3:
 566         ${POD2MAN} -c "$*" -r "" -s 3 $< >  $@