You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@locus.apache.org on 2000/09/18 14:48:19 UTC

cvs commit: httpd-docs-1.3/apidoc dict-DEFAULT_INDEX.html dict-TARGET.html TODO api.list dict-DECLINED.html todo

coar        00/09/18 05:48:18

  Modified:    apidoc   TODO api.list dict-DECLINED.html todo
  Added:       apidoc   dict-DEFAULT_INDEX.html dict-TARGET.html
  Log:
  	Some more updates.
  
  Revision  Changes    Path
  1.10      +1 -499    httpd-docs-1.3/apidoc/TODO
  
  Index: TODO
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/TODO,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -u -r1.9 -r1.10
  --- TODO	2000/09/18 11:44:45	1.9
  +++ TODO	2000/09/18 12:48:10	1.10
  @@ -1,6 +1,4 @@
   The following need to be added to api.list:
  -TARGET
  -DEFAULT_INDEX
   DEFAULT_CONTENT_TYPE
   DEFAULT_PATH
   DEFAULT_TIMEOUT
  @@ -12,7 +10,6 @@
   child_info
   
   The following have description files that need to be enhanced or re-written:
  -DECLINED
   DONE
   FLAG
   HTTPD_ROOT (refer to ap_server_root())
  @@ -98,502 +95,7 @@
   server_rec
   BUFF
   
  -The following need examples added to api.list:
  -ap_bfileno
  -ap_bflsbuf
  -ap_bflush
  -ap_bgetopt
  -ap_bgets
  -ap_bhalfduplex
  -ap_block_alarms
  -ap_blookc
  -ap_bnonblock
  -ap_bonerror
  -ap_bprintf
  -ap_bpushfd
  -ap_bputs
  -ap_bread
  -ap_bsetflag
  -ap_bsetopt
  -ap_bskiplf
  -ap_bvputs
  -ap_bwrite
  -ap_bytes_in_free_blocks
  -ap_bytes_in_pool
  -ap_call_exec
  -ap_can_exec
  -ap_cfg_closefile
  -ap_cfg_getc
  -ap_cfg_getline
  -ap_chdir_file
  -ap_checkmask
  -ap_check_alarm
  -ap_check_cmd_context
  -ap_child_exit_modules
  -ap_child_init_modules
  -ap_cleanup_for_exec
  -ap_clear_module_list
  -ap_clear_pool
  -ap_clear_table
  -ap_close_piped_log
  -ap_construct_server
  -ap_construct_url
  -ap_content_type_tolower
  -ap_copy_array
  -ap_copy_array_hdr
  -ap_copy_table
  -ap_core_reorder_directories
  -ap_count_dirs
  -ap_create_environment
  -ap_create_per_dir_config
  -ap_create_request_config
  -ap_default_port_for_request
  -ap_default_port_for_scheme
  -ap_default_type
  -ap_destroy_pool
  -ap_die
  -ap_document_root
  -ap_each_byterange
  -ap_error_log2stderr
  -ap_escape_html
  -ap_escape_path
  -ap_escape_path_segment
  -ap_escape_shell_cmd
  -ap_exists_scoreboard_image
  -ap_find_command
  -ap_find_command_in_modules
  -ap_find_last_token
  -ap_find_linked_module
  -ap_find_module_name
  -ap_find_path_info
  -ap_find_pool
  -ap_find_token
  -ap_fini_vhost_config
  -ap_fnmatch
  -ap_force_library_loading
  -ap_getparents
  -ap_getword
  -ap_getword_conf
  -ap_getword_conf_nc
  -ap_getword_nc
  -ap_getword_nulls
  -ap_getword_nulls_nc
  -ap_getword_white
  -ap_getword_white_nc
  -ap_get_basic_auth_pw
  -ap_get_client_block
  -ap_get_gmtoff
  -ap_get_local_host
  -ap_get_module_config
  -ap_get_remote_host
  -ap_get_remote_logname
  -ap_get_time
  -ap_get_token
  -ap_get_virthost_addr
  -ap_gm_timestr_822
  -ap_gname2id
  -ap_handle_command
  -ap_hard_timeout
  -ap_ht_time
  -ap_ind
  -ap_index_of_response
  -ap_init_alloc
  -ap_init_modules
  -ap_init_vhost_config
  -ap_init_virtual_host
  -ap_internal_redirect
  -ap_internal_redirect_handler
  -ap_is_directory
  -ap_is_fnmatch
  -ap_is_matchexp
  -ap_is_url
  -ap_keepalive_timeout
  -ap_kill_cleanup
  -ap_kill_cleanups_for_fd
  -ap_kill_cleanups_for_socket
  -ap_limit_section
  -ap_log_error
  -ap_log_pid
  -ap_log_printf
  -ap_log_reason
  -ap_log_rerror
  -ap_log_unixerr
  -ap_make_array
  -ap_make_dirstr
  -ap_make_dirstr_parent
  -ap_make_dirstr_prefix
  -ap_make_full_path
  -ap_make_sub_pool
  -ap_make_table
  -ap_matches_request_vhost
  -ap_md5
  -ap_md5context
  -ap_md5contextTo64
  -ap_md5digest
  -ap_MD5Final
  -ap_MD5Init
  -ap_MD5Update
  -ap_merge_per_dir_configs
  -ap_no2slash
  -ap_note_cleanups_for_fd
  -ap_note_cleanups_for_file
  -ap_note_cleanups_for_socket
  -ap_note_subprocess
  -ap_null_cleanup
  -ap_open_logs
  -ap_open_piped_log
  -ap_os_is_path_absolute
  -ap_overlay_tables
  -ap_palloc
  -ap_parseHTTPdate
  -ap_parse_htaccess
  -ap_parse_uri
  -ap_parse_uri_components
  -ap_parse_vhost_addrs
  -ap_pcalloc
  -ap_pcfg_openfile
  -ap_pcfg_open_custom
  -ap_pclosedir
  -ap_pclosef
  -ap_pclosesocket
  -ap_pduphostent
  -ap_pfclose
  -ap_pfdopen
  -ap_pfopen
  -ap_pgethostbyname
  -ap_pool_is_ancestor
  -ap_pool_join
  -ap_popendir
  -ap_popenf
  -ap_pregcomp
  -ap_pregfree
  -ap_pregsub
  -ap_psignature
  -ap_psocket
  -ap_pstrcat
  -ap_pstrdup
  -ap_pstrndup
  -ap_read_config
  -ap_read_request
  -ap_register_cleanup
  -ap_register_other_child
  -ap_remove_module
  -ap_requires
  -ap_response_code_string
  -ap_rfc1413
  -ap_rind
  -ap_rprintf
  -ap_rputc
  -ap_rputs
  -ap_run_cleanup
  -ap_rvputs
  -ap_rwrite
  -ap_scan_script_header_err
  -ap_scan_script_header_err_buff
  -ap_send_error_response
  -ap_send_fb
  -ap_send_fb_length
  -ap_send_fd
  -ap_send_fd_length
  -ap_send_header_field
  -ap_send_mmap
  -ap_send_size
  -ap_server_root_relative
  -ap_setup_client_block
  -ap_set_callback_and_alarm
  -ap_set_content_length
  -ap_set_file_slot
  -ap_set_flag_slot
  -ap_set_module_config
  -ap_set_name_virtual_host
  -ap_set_string_slot
  -ap_set_string_slot_lower
  -ap_set_sub_req_protocol
  -ap_soft_timeout
  -ap_spawn_child_err
  -ap_spawn_child_err_buff
  -ap_srm_command_loop
  -ap_start_restart
  -ap_strcasecmp_match
  -ap_strcmp_match
  -ap_str_tolower
  -ap_sub_req_lookup_file
  -ap_sub_req_lookup_uri
  -ap_table_add
  -ap_table_addn
  -ap_table_do
  -ap_table_get
  -ap_table_merge
  -ap_table_mergen
  -ap_table_set
  -ap_table_setn
  -ap_table_unset
  -ap_time_process_request
  -ap_tm2sec
  -ap_uname2id
  -ap_unblock_alarms
  -ap_unescape_url
  -ap_unparse_uri_components
  -ap_unregister_other_child
  -ap_update_child_status
  -ap_update_mtime
  -ap_update_vhost_given_ip
  -ap_uudecode
  -ap_vbprintf
  -ap_vformatter
  -ap_vformatter_buff
  -BUFF
  -cmd_parms
  -command_rec
  -configfile_t
  -conn_rec
  -OS_ASC
  -piped_log
  -proxyreqtype
  -regex_t
  -regmatch_t
  -request_rec
  -scoreboard
  -server_addr_rec
  -server_rec
  -short_score
  -uri_components
  -
  -The following need the detail files written:
  -APLOG_ALERT
  -APLOG_CRIT
  -APLOG_DEBUG
  -APLOG_EMERG
  -APLOG_ERR
  -APLOG_INFO
  -APLOG_MARK
  -APLOG_NOERRNO
  -APLOG_NOTICE
  -APLOG_WARNING
  -ap_add_module
  -ap_add_named_module
  -ap_add_per_url_conf
  -ap_allow_overrides
  -ap_basic_http_header
  -ap_bclose
  -ap_bcreate
  -ap_bfilbuf
  -ap_bfileno
  -ap_bflsbuf
  -ap_bflush
  -ap_bgetopt
  -ap_bgets
  -ap_bhalfduplex
  -ap_blookc
  -ap_bnonblock
  -ap_bonerror
  -ap_bpushfd
  -ap_bputs
  -ap_bread
  -ap_bsetflag
  -ap_bsetopt
  -ap_bskiplf
  -ap_bvputs
  -ap_bwrite
  -ap_checkmask
  -ap_check_access
  -ap_check_alarm
  -ap_check_auth
  -ap_check_cmd_context
  -ap_check_user_id
  -ap_child_exit_modules
  -ap_child_init_modules
  -ap_child_terminate
  -ap_clear_module_list
  -ap_close_piped_log
  -ap_content_type_tolower
  -ap_core_reorder_directories
  -ap_create_environment
  -ap_create_per_dir_config
  -ap_create_request_config
  -ap_default_port_for_request
  -ap_default_port_for_scheme
  -ap_default_type
  -ap_die
  -ap_discard_request_body
  -ap_each_byterange
  -ap_error_log2stderr
  -ap_exists_scoreboard_image
  -ap_finalize_request_protocol
  -ap_finalize_sub_req_protocol
  -ap_find_command
  -ap_find_command_in_modules
  -ap_find_last_token
  -ap_find_linked_module
  -ap_find_module_name
  -ap_find_path_info
  -ap_find_pool
  -ap_find_types
  -ap_fini_vhost_config
  -ap_fnmatch
  -ap_force_library_loading
  -ap_get_basic_auth_pw
  -ap_get_module_config
  -ap_get_remote_host
  -ap_get_remote_logname
  -ap_handle_command
  -ap_header_parse
  -ap_ind
  -ap_index_of_response
  -ap_init_alloc
  -ap_init_modules
  -ap_init_vhost_config
  -ap_init_virtual_host
  -ap_invoke_handler
  -ap_is_fnmatch
  -ap_is_initial_req
  -ap_limit_section
  -ap_log_error
  -ap_log_pid
  -ap_log_printf
  -ap_log_reason
  -ap_log_rerror
  -ap_log_transaction
  -ap_log_unixerr
  -ap_make_dirstr_parent
  -ap_make_dirstr_prefix
  -ap_matches_request_vhost
  -ap_md5
  -ap_md5context
  -ap_md5contextTo64
  -ap_md5digest
  -ap_MD5Final
  -ap_MD5Init
  -ap_MD5Update
  -AP_MD5_CTX
  -ap_meets_conditions
  -ap_merge_per_dir_configs
  -ap_note_auth_failure
  -ap_note_basic_auth_failure
  -ap_note_digest_auth_failure
  -ap_null_cleanup
  -ap_open_logs
  -ap_open_piped_log
  -ap_os_is_path_absolute
  -ap_parse_htaccess
  -ap_parse_uri
  -ap_parse_uri_components
  -ap_parse_vhost_addrs
  -ap_pcfg_openfile
  -ap_pcfg_open_custom
  -ap_pclosedir
  -ap_pclosesocket
  -ap_pduphostent
  -ap_pgethostbyname
  -ap_pool_is_ancestor
  -ap_pool_join
  -ap_popendir
  -ap_pregfree
  -ap_process_request
  -ap_process_resource_config
  -ap_psignature
  -ap_psocket
  -ap_read_config
  -ap_read_request
  -ap_register_other_child
  -ap_remove_loaded_module
  -ap_remove_module
  -ap_requires
  -ap_response_code_string
  -ap_rfc1413
  -ap_rflush
  -ap_rind
  -ap_run_fixups
  -ap_run_post_read_request
  -ap_rwrite
  -ap_satisfies
  -ap_scan_script_header_err
  -ap_scan_script_header_err_buff
  -ap_send_error_response
  -ap_send_header_field
  -ap_send_http_options
  -ap_send_http_trace
  -ap_send_mmap
  -ap_send_size
  -ap_server_root_relative
  -ap_setup_prelinked_modules
  -ap_set_byterange
  -ap_set_callback_and_alarm
  -ap_set_content_length
  -ap_set_etag
  -ap_set_file_slot
  -ap_set_flag_slot
  -ap_set_keepalive
  -ap_set_last_modified
  -ap_set_module_config
  -ap_set_name_virtual_host
  -ap_set_string_slot
  -ap_set_string_slot_lower
  -ap_set_sub_req_protocol
  -ap_show_directives
  -ap_show_modules
  -ap_some_auth_required
  -ap_srm_command_loop
  -ap_start_restart
  -ap_start_shutdown
  -ap_str_tolower
  -ap_sync_scoreboard_image
  -ap_table_do
  -ap_time_process_request
  -ap_translate_name
  -ap_unparse_uri_components
  -ap_unregister_other_child
  -ap_update_child_status
  -ap_update_mtime
  -ap_update_vhost_from_headers
  -ap_update_vhost_given_ip
  -ap_util_init
  -ap_util_uri_init
  -ap_validate_password
  -ap_vformatter
  -ap_vformatter_buff
  -ap_wait_t
  -array_header
  -BUFF
  -command_rec
  -configfile_t
  -DECLINE_CMD
  -HTTP_EXPECTATION_FAILED
  -HTTP_FAILED_DEPENDENCY
  -HTTP_INSUFFICIENT_STORAGE
  -HTTP_LOCKED
  -HTTP_NOT_EXTENDED
  -HTTP_PROCESSING
  -HTTP_RANGE_NOT_SATISFIABLE
  -HTTP_UNPROCESSABLE_ENTITY
  -M_COPY
  -M_LOCK
  -M_MKCOL
  -M_MOVE
  -M_PATCH
  -M_PROPFIND
  -M_UNLOCK
  -OPT_ALL
  -OPT_EXECCGI
  -OPT_INCLUDES
  -OPT_INCNOEXEC
  -OPT_INDEXES
  -OPT_MULTI
  -OPT_NONE
  -OPT_SYM_LINKS
  -OPT_SYM_OWNER
  -OPT_UNSET
  -OS_ASC
  -piped_log
  -proxyreqtype
  -regex_t
  -regmatch_t
  -scoreboard
  -SECURITY_HOLE_PASS_AUTHORIZATION
  -server_addr_rec
  -short_score
  -
  -The following items need exampless:
  +The following items need examples:
    APLOG_LEVELMASK
    APLOG_WIN32ERROR
    ap_base64decode
  
  
  
  1.30      +11 -0     httpd-docs-1.3/apidoc/api.list
  
  Index: api.list
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/api.list,v
  retrieving revision 1.29
  retrieving revision 1.30
  diff -u -u -r1.29 -r1.30
  --- api.list	2000/09/18 11:44:45	1.29
  +++ api.list	2000/09/18 12:48:11	1.30
  @@ -952,6 +952,7 @@
   X|SA-compileflags\
       |BIG_SECURITY_HOLE,DEFAULT_ADMIN,DOCUMENT_LOCATION,DYNAMIC_MODULE_LIMIT\
        ,HARD_SERVER_LIMIT,HTTPD_ROOT,SECURITY_HOLE_PASS_AUTHORIZATION\
  +     ,TARGET,DEFAULT_INDEX\
       |\
       |\
       |
  @@ -969,6 +970,16 @@
       |Compile-time definition\
       |env CFLAGS="-Wall -D$*=\"/usr/httpd/htdocs\"" ./configure\
       |SA-compileflags,ap_document_root\
  +    |<dict-$*.html
  +C|TARGET\
  +    |Compile-time definition\
  +    |env CFLAGS="-Wall -D$*=\"apache\"" ./configure\
  +    |SA-compileflags\
  +    |<dict-$*.html
  +C|DEFAULT_INDEX\
  +    |Compile-time definition\
  +    |env CFLAGS="-Wall -D$*=\"default.html\"" ./configure\
  +    |SA-compileflags\
       |<dict-$*.html
   C|DYNAMIC_MODULE_LIMIT\
       |Compile-time definition\
  
  
  
  1.3       +11 -1     httpd-docs-1.3/apidoc/dict-DECLINED.html
  
  Index: dict-DECLINED.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/dict-DECLINED.html,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -u -r1.2 -r1.3
  --- dict-DECLINED.html	2000/07/24 22:13:48	1.2
  +++ dict-DECLINED.html	2000/09/18 12:48:11	1.3
  @@ -1,3 +1,13 @@
   <p>
  -The module declines to handle this request.
  +This value is returned by modules during request phase processing.
  +It signifies that the module is declining to take responsibility for
  +the current phase, and that the core server should continue invoking
  +other modules.
  +</p>
  +<p>
  +It's possible for a module to actually take action on the request
  +when invoked, and then return <code>DECLINED</code> in order to let
  +subsequent modules have a chance at it during the current phase.
  +Though possible, this practice is strongly discouraged, and may
  +not be supported in future versions of the server.
   </p>
  
  
  
  1.2       +1 -1      httpd-docs-1.3/apidoc/todo
  
  Index: todo
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/apidoc/todo,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -u -r1.1 -r1.2
  --- todo	2000/09/18 11:44:45	1.1
  +++ todo	2000/09/18 12:48:12	1.2
  @@ -58,7 +58,7 @@
   }
   
   if (@missing_example) {
  -    print "The following items need exampless:\n";
  +    print "The following items need examples:\n";
       foreach (@missing_example) {
           print " $_\n";
       }
  
  
  
  1.1                  httpd-docs-1.3/apidoc/dict-DEFAULT_INDEX.html
  
  Index: dict-DEFAULT_INDEX.html
  ===================================================================
  <p>
  The value of the <code>DEFAULT_INDEX</code> definition is used by the
  <code>mod_dir</code> module when no <code>DirectoryIndex</code>
  directive is in effect.  For more information, refer to the
  <code>mod_dir</code> documentation.
  </p>
  <p>
  The default value is "<code>index.html</code>".  Note that, unlike the
  <code>DirectoryIndex</code> directive, this definition can only refer
  to a single document name, not a list of them.
  </p>
  
  
  
  1.1                  httpd-docs-1.3/apidoc/dict-TARGET.html
  
  Index: dict-TARGET.html
  ===================================================================
  <p>
  The <code>TARGET</code> macro is used to determine the name of
  the main Apache executable file, and locate the shared core library.
  By default its value is set to "<code>httpd</code>".
  </p>
  <p>
  You should <b>NOT</b> change this definition unless you have a
  a definite need, or have been advised by someone on the core Apache
  development team to do so.
  </p>