Changeset 25070 in project


Ignore:
Timestamp:
09/13/11 01:33:10 (10 years ago)
Author:
Mario Domenech Goulart
Message:

awful (doc): updated docs and version history for version 0.32

Location:
release/4/awful/extra/doc
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • release/4/awful/extra/doc/procedures

    r24189 r25070  
    209209
    210210===== {{define-page}}
    211 <procedure>(define-page path contents #!key css title doctype headers charset no-ajax use-ajax no-template no-session no-db no-javascript-compression)</procedure>
     211<procedure>(define-page path contents #!key css title doctype headers charset no-ajax use-ajax no-template no-session no-db no-javascript-compression method)</procedure>
    212212
    213213Define an awful page.
     
    220220one-argument procedure {{contents}}.  This procedure will be given the
    221221requested path.
     222
     223{{method}} (a symbol) indicates the HTTP method to be used (e.g.,
     224{{GET}}, {{POST}}, {{PUT}}).  Pages that use different methods can use
     225the same path.
    222226
    223227The {{css}}, {{title}}, {{doctype}}, {{headers}} and {{charset}}
     
    308312
    309313===== {{ajax}}
    310 <procedure>(ajax path selector event proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db vhost-root-path live prelude update-targets cache)</procedure>
     314<procedure>(ajax path selector event proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db vhost-root-path live prelude update-targets cache error-handler)</procedure>
    311315
    312316Generate javascript code to be added to the page defined by
     
    426430further details.
    427431
     432The {{error-handler}} keyword parameter expects a JavaScript callback
     433to be used as the error handler for the Ajax request.  See the
     434{{error}} attribute for the {{settings}} object given as argument to
     435jQuery.ajax
     436([[http://api.jquery.com/jQuery.ajax/|http://api.jquery.com/jQuery.ajax/]]).
     437
    428438The {{ajax}} procedure is session, HTTP request and database -aware.
    429439
    430440
    431441===== {{periodical-ajax}}
    432 <procedure>(periodical-ajax path interval proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db vhost-root-path live prelude update-targets)</procedure>
     442<procedure>(periodical-ajax path interval proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db vhost-root-path live prelude update-targets error-handler)</procedure>
    433443
    434444Periodically execute {{proc}} on the server side, using
     
    443453
    444454===== {{ajax-link}}
    445 <procedure>(ajax-link path id text proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db (event 'click) vhost-root-path live class hreflang type rel rev charset coords shape accesskey tabindex a-target prelude update-targets)</procedure>
     455<procedure>(ajax-link path id text proc #!key target (action 'html) (method 'POST) (arguments '()) success no-session no-db (event 'click) vhost-root-path live class hreflang type rel rev charset coords shape accesskey tabindex a-target prelude update-targets error-handler)</procedure>
    446456
    447457A shortcut to
  • release/4/awful/extra/doc/version-history

    r24268 r25070  
    22
    33===== version 0.32
    4 * Updated JQuery from version 1.5.2 to 1.6.2
    5 * Added the {{reload-apps}} procedure. {{load-apps}} no longer resets the resources table.
    6 * {{awful-start}} requires a thunk as argument. With this, awful can be embedded into standalone applications.
     4* Added {{method}} keyword parameter for {{define-page}}.  Now the page router takes into account the HTTP method, so it is possible to have two different pages using the same path but different methods.
     5* Added {{error-handler}} keyword parameter for {{ajax}}, {{ajax-link}} and {{periodical-ajax}} (suggested by Thomas Hintz)
     6* {{ajax}} and friends send {{Content-Type: application/json}} when {{update-targets}} is non-#f
     7* {{ajax}} bugfix: only opens db connection and refresh session when the page access is allowed
     8* The default value for {{awful-backlog}} has been set to 100
     9* Updated JQuery from version 1.5.2 to 1.6.3
     10* Dropped {{-lambda-lift}} build option
     11* Added the {{reload-apps}} procedure. {{load-apps}} no longer resets the resources table
     12* {{awful-start}} requires a thunk as argument. With this, awful can be embedded into standalone applications
    713
    814
Note: See TracChangeset for help on using the changeset viewer.