[Cmake-commits] [cmake-commits] king committed FindBISON.cmake 1.3 1.4 FindFLEX.cmake 1.2 1.3 FindProtobuf.cmake 1.5 1.6

[cmake-commits at cmake.org]

Update of /cvsroot/CMake/CMake/Modules
In directory public:/mounts/ram/cvs-serv6245/Modules

Modified Files:
	FindBISON.cmake FindFLEX.cmake FindProtobuf.cmake 
Log Message:
Fix module docs to be manpage (groff) friendly

Most problems are fixed (or rather worked-around) by making long '====='
separators pre-formatted (i.e. prefixed with two spaces).  In order to
preserve visual view, the code examples themselves are prefixed with 3
spaces.

This commit fixes the following man warnings:

$ cmake --help-man - | LANG=C MANWIDTH=80 man --warnings -l - > /dev/null
  <standard input>:6024: warning [p 105, 1.7i]: can't break line
  <standard input>:6027: warning [p 105, 2.7i]: cannot adjust line
  <standard input>:6027: warning [p 105, 2.8i]: can't break line
  <standard input>:7142: warning [p 117, 7.8i]: can't break line
  <standard input>:7171: warning [p 117, 11.8i]: can't break line
  <standard input>:8878: warning [p 136, 9.0i]: can't break line
  <standard input>:8887: warning [p 136, 11.5i]: cannot adjust line
  <standard input>:8887: warning [p 136, 11.7i]: can't break line
  <standard input>:8904: warning [p 136, 14.2i]: can't break line

Patch from Modestas Vainius.  See issue #9659.


Index: FindProtobuf.cmake
===================================================================
RCS file: /cvsroot/CMake/CMake/Modules/FindProtobuf.cmake,v
retrieving revision 1.5
retrieving revision 1.6
diff -C 2 -d -r1.5 -r1.6
*** FindProtobuf.cmake	28 Sep 2009 15:45:40 -0000	1.5
--- FindProtobuf.cmake	5 Oct 2009 14:28:05 -0000	1.6
***************
*** 12,29 ****
  #   PROTOBUF_PROTOC_EXECUTABLE - The protoc compiler
  #
! #====================================================================
! # Example:
  #
! # find_package(Protobuf REQUIRED)
! # include_directories(${PROTOBUF_INCLUDE_DIRS})
  #
! # include_directories(${CMAKE_CURRENT_BINARY_DIR})
! # PROTOBUF_GENERATE_CPP(PROTO_SRCS PROTO_HDRS foo.proto)
! # add_executable(bar bar.cc ${PROTO_SRCS} ${PROTO_HDRS})
! # target_link_libraries(bar ${PROTOBUF_LIBRARY})
  #
  # NOTE: You may need to link against pthreads, depending
  # on the platform.
! #====================================================================
  #
  # PROTOBUF_GENERATE_CPP (public function)
--- 12,29 ----
  #   PROTOBUF_PROTOC_EXECUTABLE - The protoc compiler
  #
! #  ====================================================================
! #  Example:
  #
! #   find_package(Protobuf REQUIRED)
! #   include_directories(${PROTOBUF_INCLUDE_DIRS})
  #
! #   include_directories(${CMAKE_CURRENT_BINARY_DIR})
! #   PROTOBUF_GENERATE_CPP(PROTO_SRCS PROTO_HDRS foo.proto)
! #   add_executable(bar bar.cc ${PROTO_SRCS} ${PROTO_HDRS})
! #   target_link_libraries(bar ${PROTOBUF_LIBRARY})
  #
  # NOTE: You may need to link against pthreads, depending
  # on the platform.
! #  ====================================================================
  #
  # PROTOBUF_GENERATE_CPP (public function)
***************
*** 34,38 ****
  #   ARGN = proto files
  #
! #====================================================================
  
  
--- 34,38 ----
  #   ARGN = proto files
  #
! #  ====================================================================
  
  

Index: FindBISON.cmake
===================================================================
RCS file: /cvsroot/CMake/CMake/Modules/FindBISON.cmake,v
retrieving revision 1.3
retrieving revision 1.4
diff -C 2 -d -r1.3 -r1.4
*** FindBISON.cmake	28 Sep 2009 15:45:33 -0000	1.3
--- FindBISON.cmake	5 Oct 2009 14:28:02 -0000	1.4
***************
*** 23,33 ****
  #  BISON_${Name}_COMPILE_FLAGS - Options used in the bison command line
  #
! #====================================================================
! # Example:
  #
! # find_package(BISON)
! # BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp)
! # add_executable(Foo main.cpp ${BISON_MyParser_OUTPUTS})
! #====================================================================
  
  #=============================================================================
--- 23,33 ----
  #  BISON_${Name}_COMPILE_FLAGS - Options used in the bison command line
  #
! #  ====================================================================
! #  Example:
  #
! #   find_package(BISON)
! #   BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp)
! #   add_executable(Foo main.cpp ${BISON_MyParser_OUTPUTS})
! #  ====================================================================
  
  #=============================================================================

Index: FindFLEX.cmake
===================================================================
RCS file: /cvsroot/CMake/CMake/Modules/FindFLEX.cmake,v
retrieving revision 1.2
retrieving revision 1.3
diff -C 2 -d -r1.2 -r1.3
*** FindFLEX.cmake	28 Sep 2009 15:45:33 -0000	1.2
--- FindFLEX.cmake	5 Oct 2009 14:28:04 -0000	1.3
***************
*** 27,47 ****
  # respectively FLEX_TARGET and BISON_TARGET macros.
  #
! #====================================================================
! # Example:
  #
! #  find_package(BISON)
! #  find_package(FLEX)
  #
! #  BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp
! #  FLEX_TARGET(MyScanner lexer.l  ${CMAKE_CURRENT_BIANRY_DIR}/lexer.cpp)
! #  ADD_FLEX_BISON_DEPENDENCY(MyScanner MyParser)
  #
! #  include_directories(${CMAKE_CURRENT_BINARY_DIR})
! #  add_executable(Foo
! #     Foo.cc
! #     ${BISON_MyParser_OUTPUTS}
! #     ${FLEX_MyScanner_OUTPUTS}
! #  )
! #====================================================================
  
  #=============================================================================
--- 27,47 ----
  # respectively FLEX_TARGET and BISON_TARGET macros.
  #
! #  ====================================================================
! #  Example:
  #
! #   find_package(BISON)
! #   find_package(FLEX)
  #
! #   BISON_TARGET(MyParser parser.y ${CMAKE_CURRENT_BINARY_DIR}/parser.cpp
! #   FLEX_TARGET(MyScanner lexer.l  ${CMAKE_CURRENT_BIANRY_DIR}/lexer.cpp)
! #   ADD_FLEX_BISON_DEPENDENCY(MyScanner MyParser)
  #
! #   include_directories(${CMAKE_CURRENT_BINARY_DIR})
! #   add_executable(Foo
! #      Foo.cc
! #      ${BISON_MyParser_OUTPUTS}
! #      ${FLEX_MyScanner_OUTPUTS}
! #   )
! #  ====================================================================
  
  #=============================================================================