Updated docs

This commit is contained in:
Norman Clarke 2013-02-12 23:26:30 -03:00
parent d8a260b09b
commit df50d35914
5 changed files with 28 additions and 19 deletions

View File

@ -1,6 +1,6 @@
# Haml Changelog
## 4.0.0 (Unreleased)
## 4.0.0
* The Haml exectutable now accepts an `--autoclose` option. You can now
specify a list of tags that should be autoclosed
@ -64,7 +64,7 @@
with a helper method that makes adding support for other Tilt-based template
engines trivial.
As of 3.2, Haml will also ship with a "haml-contrib" gem that includes useful
As of 4.0, Haml will also ship with a "haml-contrib" gem that includes useful
but less-frequently used filters and helpers. This includes several additional
filters such as Nokogiri, Yajl, Markaby, and others.
@ -105,10 +105,16 @@
* Add command-line option to suppress script evaluation.
* It's now possible to use Rails's asset helpers inside the Sass and SCSS
filters.
filters. Note that to do so, you must make sure sass-rails is loaded in
production, usually by moving it out of the assets gem group.
* The Haml project now uses [semantic versioning](http://semver.org/).
## 3.2.0
The Haml 3.2 series was released only as far as 3.2.0.rc.4, but then was
renamed to Haml 4.0 when the project adopted semantic versioning.
## 3.1.6
* In indented mode, don't reindent buffers that contain preserved tags, and

View File

@ -129,20 +129,23 @@ on a specific area:
Haml supports Ruby 1.8.7 and higher, so please make sure your changes run on
both 1.9 and 1.8.
## Authors
## Team
### Current Maintainers
* [Norman Clarke](http://github.com/norman)
* [Matt Wildig](http://github.com/mattwildig)
* [Akira Matsuda](https://github.com/amatsuda)
### Alumni
Haml was created by [Hampton Catlin](http://hamptoncatlin.com), the author of
the original implementation. However, Hampton doesn't even know his way around
the code anymore and now just occasionally consults on the language issues.
the original implementation. Hampton is no longer involved in day-to-day coding,
but still consults on language issues.
[Nathan Weizenbaum](http://nex-3.com) was for many years the primary developer
and architect of the "modern" Ruby implementation of Haml. His hard work
endlessly answering forum posts, fixing bugs, refactoring, finding speed
improvements, writing documentation, and implementing new features is what has
kept the project alive.
and architect of the "modern" Ruby implementation of Haml.
[Norman Clarke](http://github.com/norman), the author of Haml Spec and the Haml
implementation in Lua, took over as maintainer in April 2012.
## License
@ -150,7 +153,7 @@ Some of Nathan's work on Haml was supported by Unspace Interactive.
Beyond that, the implementation is licensed under the MIT License.
Copyright (c) 2006-2009 Hampton Catlin and Nathan Weizenbaum
Copyright (c) 2006-2013 Hampton Catlin, Nathan Weizenbaum and the Haml team
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in

View File

@ -1131,7 +1131,7 @@ implemented using Tilt.
Parses the filtered text with [Maruku](https://github.com/nex3/maruku), which
has some non-standard extensions to Markdown.
As of Haml 3.2, this filter is defined in [Haml
As of Haml 4.0, this filter is defined in [Haml
contrib](https://github.com/haml/haml-contrib) but is loaded automatically for
historical reasons. In future versions of Haml it will likely not be loaded by
default. This filter is implemented using Tilt.
@ -1171,7 +1171,7 @@ SCSS syntax to produce CSS output. This filter is implemented using Tilt.
Parses the filtered text with [Textile](http://www.textism.com/tools/textile).
Only works if [RedCloth](http://redcloth.org) is installed.
As of Haml 3.2, this filter is defined in [Haml
As of Haml 4.0, this filter is defined in [Haml
contrib](https://github.com/haml/haml-contrib) but is loaded automatically for
historical reasons. In future versions of Haml it will likely not be loaded by
default. This filter is implemented using Tilt.

View File

@ -34,7 +34,7 @@ module Haml
# @option options [String] :extend The name of a module to extend when
# defining the filter. Defaults to "Plain". This allows filters such as
# Coffee to "inherit" from Javascript, wrapping its output in script tags.
# @since 3.2.0
# @since 4.0
def register_tilt_filter(name, options = {})
if constants.map(&:to_s).include?(name.to_s)
raise "#{name} filter already defined"
@ -63,7 +63,7 @@ module Haml
# to redefine a filter, Haml will raise an error. Use this method first to
# explicitly remove the filter before redefining it.
# @return Module The filter module that has been removed
# @since 3.2.0
# @since 4.0
def remove_filter(name)
defined.delete name.to_s.downcase
if constants.map(&:to_s).include?(name.to_s)
@ -393,7 +393,7 @@ RUBY
end
# These filters have been demoted to Haml Contrib but are still included by
# default in Haml 3.2. Still, we rescue from load error if for some reason
# default in Haml 4.0. Still, we rescue from load error if for some reason
# haml-contrib is not installed.
begin
require "haml/filters/maruku"

View File

@ -97,7 +97,7 @@ module Haml
# If set to `true`, Haml will convert underscores to hyphens in all
# {file:REFERENCE.md#html5_custom_data_attributes Custom Data Attributes} As
# of Haml 3.2, this defaults to `true`.
# of Haml 4.0, this defaults to `true`.
attr_accessor :hyphenate_data_attrs
# The line offset of the Haml template being parsed. This is useful for