grpc/include/grpcpp/impl/codegen
Yijie Ma f99b8b5bc4
Convert c-style comments to C++-style comments (#31923)
* baseline

* fix clang-tidy

* manually revert these files

* manually fixup at eof

* revert 2 more files

* change check_deprecated_grpc++.py

* change end2end_defs.include template

* fix check_include_guards.py

* untrack tools/distrib/python/convert_cstyle_comments_to_cpp.py

not yet ready to be submitted

* fix

yapf check_include_guards.py
remove a space...

* fix version.cc.template

* fix version_info.h.template
2022-12-22 23:01:53 -08:00
..
security Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
README.md Justify existence of this directory 2020-08-17 11:42:36 -07:00
async_generic_service.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
async_stream.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
async_unary_call.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
byte_buffer.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
call.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
call_hook.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
call_op_set.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
call_op_set_interface.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
callback_common.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
channel_interface.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
client_callback.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
client_context.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
client_interceptor.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
client_unary_call.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
completion_queue.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
completion_queue_tag.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
config.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
config_protobuf.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
create_auth_context.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
delegating_channel.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
intercepted_channel.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
interceptor.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
interceptor_common.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
message_allocator.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
metadata_map.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
method_handler.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
method_handler_impl.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
proto_buffer_reader.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
proto_buffer_writer.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
proto_utils.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
rpc_method.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
rpc_service_method.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
serialization_traits.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
server_callback.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
server_callback_handlers.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
server_context.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
server_interceptor.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
server_interface.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
service_type.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
slice.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
status.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
status_code_enum.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
string_ref.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
stub_options.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
sync.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
sync_stream.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00
time.h Convert c-style comments to C++-style comments (#31923) 2022-12-22 23:01:53 -08:00

README.md

Welcome to include/grpcpp/impl/codegen

Why is this directory here?

This directory exists so that generated code can include selected files upon which it depends without having to depend on the entire gRPC C++ library. This is particularly relevant for users of bazel, particularly if they use the multi-lingual proto_library target type. Generated code that uses this target only depends on the gRPC C++ targets associated with these header files, not the entire gRPC C++ codebase since that would make the build time of these types of targets excessively large (particularly when they are not even C++ specific).

What should user code do?

User code should not include anything from this directory. Only generated code and gRPC library code should include contents from this directory. User code should instead include contents from the main grpcpp directory or its accessible subcomponents like grpcpp/support. It is possible that we may remove this directory altogether if the motivations for its existence are no longer strong enough (e.g., if most users migrate away from the proto_library target type or if the additional overhead of depending on gRPC C++ is not high).